---
url: >-
  https://adk.nht.io/api/@nhtio/adk/batteries/llm/bedrock_converse/types/interfaces/BedrockConverseHelpers.md
description: >-
  The injectable translation seam. Every function has a `default*`
  implementation.
---

# Interface: BedrockConverseHelpers

Defined in: [src/batteries/llm/bedrock\_converse/types.ts:234](https://github.com/NHTIO/ADK/blob/v1.20261003.0/src/src/batteries/llm/bedrock_converse/types.ts#L234)

The injectable translation seam. Every function has a `default*` implementation.

## Remarks

`buildConverseRequest` is the ordering seam — it is where ADK primitives become `messages[]`,
including the alternation repair Converse requires. A consumer needing different behaviour
overrides it rather than forking.

## Extends

* [`ChatHelpersCommon`](../../../openai_responses/interfaces/ChatHelpersCommon.md)

## Properties

| Property                                                                                              | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | Inherited from                                                                                                                                                                                                                         | Defined in                                                                                                                                              |
| ----------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  `buildConverseRequest`                                     | (`input`: [`ConverseRequestBuildInput`](ConverseRequestBuildInput.md)) => `Promise`<[`ConverseRequest`](ConverseRequest.md)>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | Assemble the full request from turn state. The primary ordering seam.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | -                                                                                                                                                                                                                                      | [src/batteries/llm/bedrock\_converse/types.ts:248](https://github.com/NHTIO/ADK/blob/v1.20261003.0/src/src/batteries/llm/bedrock_converse/types.ts#L248) |
|  `descriptionToChatCompletionsJsonSchema` | (`d`: [`DescriptionLike`](../../../../interfaces/DescriptionLike.md)) => [`JsonSchema`](../../../../interfaces/JsonSchema.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | Converts a validator `describe()` envelope into the Chat-Completions JSON-Schema subset.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | [`ChatHelpersCommon`](../../../openai_responses/interfaces/ChatHelpersCommon.md).[`descriptionToChatCompletionsJsonSchema`](../../../openai_responses/interfaces/ChatHelpersCommon.md#property-descriptiontochatcompletionsjsonschema) | [src/batteries/llm/chat\_common/types.ts:511](https://github.com/NHTIO/ADK/blob/v1.20261003.0/src/src/batteries/llm/chat_common/types.ts#L511)           |
|  `filterThoughts`                                                 | (`thoughts`: `Iterable`<[`Thought`](../../../../../common/classes/Thought.md)>, `mode`: `"all"` | `"all-self"` | `"latest-self"`, `selfIdentity`: `string`, `replayCompatibility`: readonly `string`\[]) => [`Thought`](../../../../../common/classes/Thought.md)\[]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Selects which thoughts to surface, by surfacing mode, self identity, and replay compatibility.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | [`ChatHelpersCommon`](../../../openai_responses/interfaces/ChatHelpersCommon.md).[`filterThoughts`](../../../openai_responses/interfaces/ChatHelpersCommon.md#property-filterthoughts)                                                 | [src/batteries/llm/chat\_common/types.ts:599](https://github.com/NHTIO/ADK/blob/v1.20261003.0/src/src/batteries/llm/chat_common/types.ts#L599)           |
|  `renderArtifactHandleBody?`                            | (`input`: { `artifact`: `unknown`; `byteLength`: `number`; `callId`: `string`; `encoding?`: `string`; `estimatedTokens?`: `number`; `lineCount`: `number`; }) => `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | Renders the directions-bearing "handle" body for a non-inlined [@nhtio/adk!SpooledArtifact](../../../../../spooled_artifact/classes/SpooledArtifact.md) tool result: metadata (callId/kind/byteLength/lineCount) plus the forged `artifact_*` tools the model should call to read it incrementally. **Remarks** Optional override seam. When omitted the battery uses the shared defaultRenderArtifactHandleBody. A consumer overrides it to change WHICH reader the model is steered toward first — e.g. promoting the JSON content-readers (`artifact_json_get` / `artifact_json_keys`) ahead of the metadata-only `artifact_json_type` for a small model that grabs the first listed tool. The tool list itself comes from the artifact's `constructor.toolMethods`; an override typically reorders or re-annotates that list before delegating to the default renderer. | [`ChatHelpersCommon`](../../../openai_responses/interfaces/ChatHelpersCommon.md).[`renderArtifactHandleBody`](../../../openai_responses/interfaces/ChatHelpersCommon.md#property-renderartifacthandlebody)                             | [src/batteries/llm/chat\_common/types.ts:571](https://github.com/NHTIO/ADK/blob/v1.20261003.0/src/src/batteries/llm/chat_common/types.ts#L571)           |
|  `renderChatCompletionsSystemPrompt`           | (`input`: { `bucketOrder`: [`ChatCompletionsBucketOrder`](../../../../type-aliases/ChatCompletionsBucketOrder.md); `memories`: `Iterable`<[`Memory`](../../../../../common/classes/Memory.md)>; `renderCtx?`: `unknown`; `renderFirstPartyRetrievables`: (`items`: `Iterable`<{ `attrs`: [`RetrievableAttrs`](../../../../interfaces/RetrievableAttrs.md); `retrievable`: [`Retrievable`](../../../../../common/classes/Retrievable.md); }>, `renderRetrievableHandleBody?`: (`input`: { `artifact`: `unknown`; `byteLength`: `number`; `callId`: `string`; `encoding?`: `string`; `estimatedTokens?`: `number`; `lineCount`: `number`; }) => `string`) => `Promise`<`string`>; `renderMemories`: (`items`: `Iterable`<{ `attrs`: [`MemoryAttrs`](../../../../interfaces/MemoryAttrs.md); `memory`: [`Memory`](../../../../../common/classes/Memory.md); }>) => `string`; `renderRetrievableHandleBody?`: (`input`: { `artifact`: `unknown`; `byteLength`: `number`; `callId`: `string`; `encoding?`: `string`; `estimatedTokens?`: `number`; `lineCount`: `number`; }) => `string`; `renderRetrievables`: (`items`: `Iterable`<{ `attrs`: [`RetrievableAttrs`](../../../../interfaces/RetrievableAttrs.md); `retrievable`: [`Retrievable`](../../../../../common/classes/Retrievable.md); }>, `deps`: { `renderFirstPartyRetrievables`: (`items`: `Iterable`<{ `attrs`: [`RetrievableAttrs`](../../../../interfaces/RetrievableAttrs.md); `retrievable`: [`Retrievable`](../../../../../common/classes/Retrievable.md); }>, `renderRetrievableHandleBody?`: (`input`: { `artifact`: `unknown`; `byteLength`: `number`; `callId`: `string`; `encoding?`: `string`; `estimatedTokens?`: `number`; `lineCount`: `number`; }) => `string`) => `Promise`<`string`>; `renderRetrievableHandleBody?`: (`input`: { `artifact`: `unknown`; `byteLength`: `number`; `callId`: `string`; `encoding?`: `string`; `estimatedTokens?`: `number`; `lineCount`: `number`; }) => `string`; `renderRetrievableSafetyDirective`: () => `string`; `renderThirdPartyPrivateRetrievables`: (`items`: `Iterable`<{ `attrs`: [`RetrievableAttrs`](../../../../interfaces/RetrievableAttrs.md); `retrievable`: [`Retrievable`](../../../../../common/classes/Retrievable.md); }>, `deps`: { `renderRetrievableHandleBody?`: (`input`: { `artifact`: `unknown`; `byteLength`: `number`; `callId`: `string`; `encoding?`: `string`; `estimatedTokens?`: `number`; `lineCount`: `number`; }) => `string`; `renderUntrustedContent`: (`content`: `string`, `attrs`: [`UntrustedContentAttrs`](../../../../interfaces/UntrustedContentAttrs.md)) => `string`; }) => `Promise`<`string`>; `renderThirdPartyPublicRetrievables`: (`items`: `Iterable`<{ `attrs`: [`RetrievableAttrs`](../../../../interfaces/RetrievableAttrs.md); `retrievable`: [`Retrievable`](../../../../../common/classes/Retrievable.md); }>, `deps`: { `renderRetrievableHandleBody?`: (`input`: { `artifact`: `unknown`; `byteLength`: `number`; `callId`: `string`; `encoding?`: `string`; `estimatedTokens?`: `number`; `lineCount`: `number`; }) => `string`; `renderUntrustedContent`: (`content`: `string`, `attrs`: [`UntrustedContentAttrs`](../../../../interfaces/UntrustedContentAttrs.md)) => `string`; }) => `Promise`<`string`>; `renderUntrustedContent`: (`content`: `string`, `attrs`: [`UntrustedContentAttrs`](../../../../interfaces/UntrustedContentAttrs.md)) => `string`; }) => `Promise`<`string`>; `renderRetrievableSafetyDirective`: () => `string`; `renderStandingInstructions`: (`items`: `Iterable`<[`Tokenizable`](../../../../../common/classes/Tokenizable.md)>, `attrs?`: [`StandingInstructionAttrs`](../../../../interfaces/StandingInstructionAttrs.md)) => `string`; `renderThirdPartyPrivateRetrievables`: (`items`: `Iterable`<{ `attrs`: [`RetrievableAttrs`](../../../../interfaces/RetrievableAttrs.md); `retrievable`: [`Retrievable`](../../../../../common/classes/Retrievable.md); }>, `deps`: { `renderRetrievableHandleBody?`: (`input`: { `artifact`: `unknown`; `byteLength`: `number`; `callId`: `string`; `encoding?`: `string`; `estimatedTokens?`: `number`; `lineCount`: `number`; }) => `string`; `renderUntrustedContent`: (`content`: `string`, `attrs`: [`UntrustedContentAttrs`](../../../../interfaces/UntrustedContentAttrs.md)) => `string`; }) => `Promise`<`string`>; `renderThirdPartyPublicRetrievables`: (`items`: `Iterable`<{ `attrs`: [`RetrievableAttrs`](../../../../interfaces/RetrievableAttrs.md); `retrievable`: [`Retrievable`](../../../../../common/classes/Retrievable.md); }>, `deps`: { `renderRetrievableHandleBody?`: (`input`: { `artifact`: `unknown`; `byteLength`: `number`; `callId`: `string`; `encoding?`: `string`; `estimatedTokens?`: `number`; `lineCount`: `number`; }) => `string`; `renderUntrustedContent`: (`content`: `string`, `attrs`: [`UntrustedContentAttrs`](../../../../interfaces/UntrustedContentAttrs.md)) => `string`; }) => `Promise`<`string`>; `renderUntrustedContent`: (`content`: `string`, `attrs`: [`UntrustedContentAttrs`](../../../../interfaces/UntrustedContentAttrs.md)) => `string`; `retrievables`: `Iterable`<[`Retrievable`](../../../../../common/classes/Retrievable.md)>; `standingInstructions`: `Iterable`<[`Tokenizable`](../../../../../common/classes/Tokenizable.md)>; `systemPrompt`: [`Tokenizable`](../../../../../common/classes/Tokenizable.md); }) => `Promise`<`string`> | Assembles the system-prompt message from its constituent buckets in [ChatCompletionsBucketOrder](../../../../type-aliases/ChatCompletionsBucketOrder.md).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | [`ChatHelpersCommon`](../../../openai_responses/interfaces/ChatHelpersCommon.md).[`renderChatCompletionsSystemPrompt`](../../../openai_responses/interfaces/ChatHelpersCommon.md#property-renderchatcompletionssystemprompt)           | [src/batteries/llm/chat\_common/types.ts:611](https://github.com/NHTIO/ADK/blob/v1.20261003.0/src/src/batteries/llm/chat_common/types.ts#L611)           |
|  `renderConverseToolResult`                             | (`input`: { `renderTrustedContent`: (`content`: `string`, `attrs`: [`TrustedContentAttrs`](../../../../interfaces/TrustedContentAttrs.md)) => `string`; `renderUntrustedContent`: (`content`: `string`, `attrs`: [`UntrustedContentAttrs`](../../../../interfaces/UntrustedContentAttrs.md)) => `string`; `results`: | [`Tokenizable`](../../../../../common/classes/Tokenizable.md) | [`SpooledArtifact`](../../../../../spooled_artifact/classes/SpooledArtifact.md) | [`Media`](../../../../../common/classes/Media.md) | [`Media`](../../../../../common/classes/Media.md)\[] | [`SpooledArtifact`](../../../../../spooled_artifact/classes/SpooledArtifact.md)\[]; `tool`: | [`Tool`](../../../../../forge/classes/Tool.md)<[`SpooledArtifact`](../../../../../spooled_artifact/classes/SpooledArtifact.md)> | [`ArtifactTool`](../../../../../forge/classes/ArtifactTool.md) | `undefined`; `toolCall`: [`ToolCall`](../../../../../forge/classes/ToolCall.md); `unsupportedMediaPolicy`: | [`UnsupportedMediaPolicy`](../../../transformers_js/type-aliases/UnsupportedMediaPolicy.md) | `undefined`; `warn?`: (`message`: `string`) => `void`; }) => `Promise`<{ `json?`: [`Record`](https://www.typescriptlang.org/docs/handbook/utility-types.html#recordkeys-type)<`string`, `unknown`>; `text?`: `string`; }\[]>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | Render one tool result into `toolResult.content[]`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | -                                                                                                                                                                                                                                      | [src/batteries/llm/bedrock\_converse/types.ts:238](https://github.com/NHTIO/ADK/blob/v1.20261003.0/src/src/batteries/llm/bedrock_converse/types.ts#L238) |
|  `renderFirstPartyRetrievables`                     | (`items`: `Iterable`<{ `attrs`: [`RetrievableAttrs`](../../../../interfaces/RetrievableAttrs.md); `retrievable`: [`Retrievable`](../../../../../common/classes/Retrievable.md); }>, `renderRetrievableHandleBody?`: (`input`: { `artifact`: `unknown`; `byteLength`: `number`; `callId`: `string`; `encoding?`: `string`; `estimatedTokens?`: `number`; `lineCount`: `number`; }) => `string`) => `Promise`<`string`>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | Renders first-party (trusted) retrievables into a single prompt block.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | [`ChatHelpersCommon`](../../../openai_responses/interfaces/ChatHelpersCommon.md).[`renderFirstPartyRetrievables`](../../../openai_responses/interfaces/ChatHelpersCommon.md#property-renderfirstpartyretrievables)                     | [src/batteries/llm/chat\_common/types.ts:526](https://github.com/NHTIO/ADK/blob/v1.20261003.0/src/src/batteries/llm/chat_common/types.ts#L526)           |
|  `renderMemories`                                                 | (`items`: `Iterable`<{ `attrs`: [`MemoryAttrs`](../../../../interfaces/MemoryAttrs.md); `memory`: [`Memory`](../../../../../common/classes/Memory.md); }>) => `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | Renders memories (each with its attribute bag) into a single prompt block.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | [`ChatHelpersCommon`](../../../openai_responses/interfaces/ChatHelpersCommon.md).[`renderMemories`](../../../openai_responses/interfaces/ChatHelpersCommon.md#property-rendermemories)                                                 | [src/batteries/llm/chat\_common/types.ts:522](https://github.com/NHTIO/ADK/blob/v1.20261003.0/src/src/batteries/llm/chat_common/types.ts#L522)           |
|  `renderRetrievableHandleBody?`                      | (`input`: { `artifact`: `unknown`; `byteLength`: `number`; `callId`: `string`; `encoding?`: `string`; `estimatedTokens?`: `number`; `lineCount`: `number`; }) => `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | Renders the directions-bearing "handle" body for a non-inlined [@nhtio/adk!Retrievable](../../../../../common/classes/Retrievable.md) whose content is a [@nhtio/adk!SpooledArtifact](../../../../../spooled_artifact/classes/SpooledArtifact.md): metadata (callId/kind/byteLength/lineCount) plus the forged `artifact_*` tools the model should call to read it incrementally. **Remarks** Optional override seam, the retrievable-side counterpart to [renderArtifactHandleBody](../../../openai_responses/interfaces/ChatHelpersCommon.md#property-renderartifacthandlebody). When omitted the battery uses the shared defaultRenderRetrievableHandleBody.                                                                                                                                                                                                             | [`ChatHelpersCommon`](../../../openai_responses/interfaces/ChatHelpersCommon.md).[`renderRetrievableHandleBody`](../../../openai_responses/interfaces/ChatHelpersCommon.md#property-renderretrievablehandlebody)                       | [src/batteries/llm/chat\_common/types.ts:588](https://github.com/NHTIO/ADK/blob/v1.20261003.0/src/src/batteries/llm/chat_common/types.ts#L588)           |
|  `renderRetrievables`                                         | (`items`: `Iterable`<{ `attrs`: [`RetrievableAttrs`](../../../../interfaces/RetrievableAttrs.md); `retrievable`: [`Retrievable`](../../../../../common/classes/Retrievable.md); }>, `deps`: { `renderFirstPartyRetrievables`: (`items`: `Iterable`<{ `attrs`: [`RetrievableAttrs`](../../../../interfaces/RetrievableAttrs.md); `retrievable`: [`Retrievable`](../../../../../common/classes/Retrievable.md); }>, `renderRetrievableHandleBody?`: (`input`: { `artifact`: `unknown`; `byteLength`: `number`; `callId`: `string`; `encoding?`: `string`; `estimatedTokens?`: `number`; `lineCount`: `number`; }) => `string`) => `Promise`<`string`>; `renderRetrievableHandleBody?`: (`input`: { `artifact`: `unknown`; `byteLength`: `number`; `callId`: `string`; `encoding?`: `string`; `estimatedTokens?`: `number`; `lineCount`: `number`; }) => `string`; `renderRetrievableSafetyDirective`: () => `string`; `renderThirdPartyPrivateRetrievables`: (`items`: `Iterable`<{ `attrs`: [`RetrievableAttrs`](../../../../interfaces/RetrievableAttrs.md); `retrievable`: [`Retrievable`](../../../../../common/classes/Retrievable.md); }>, `deps`: { `renderRetrievableHandleBody?`: (`input`: { `artifact`: `unknown`; `byteLength`: `number`; `callId`: `string`; `encoding?`: `string`; `estimatedTokens?`: `number`; `lineCount`: `number`; }) => `string`; `renderUntrustedContent`: (`content`: `string`, `attrs`: [`UntrustedContentAttrs`](../../../../interfaces/UntrustedContentAttrs.md)) => `string`; }) => `Promise`<`string`>; `renderThirdPartyPublicRetrievables`: (`items`: `Iterable`<{ `attrs`: [`RetrievableAttrs`](../../../../interfaces/RetrievableAttrs.md); `retrievable`: [`Retrievable`](../../../../../common/classes/Retrievable.md); }>, `deps`: { `renderRetrievableHandleBody?`: (`input`: { `artifact`: `unknown`; `byteLength`: `number`; `callId`: `string`; `encoding?`: `string`; `estimatedTokens?`: `number`; `lineCount`: `number`; }) => `string`; `renderUntrustedContent`: (`content`: `string`, `attrs`: [`UntrustedContentAttrs`](../../../../interfaces/UntrustedContentAttrs.md)) => `string`; }) => `Promise`<`string`>; `renderUntrustedContent`: (`content`: `string`, `attrs`: [`UntrustedContentAttrs`](../../../../interfaces/UntrustedContentAttrs.md)) => `string`; }) => `Promise`<`string`>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | Assembles the full retrievables block: safety directive plus the trust-tiered sub-renderers.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | [`ChatHelpersCommon`](../../../openai_responses/interfaces/ChatHelpersCommon.md).[`renderRetrievables`](../../../openai_responses/interfaces/ChatHelpersCommon.md#property-renderretrievables)                                         | [src/batteries/llm/chat\_common/types.ts:547](https://github.com/NHTIO/ADK/blob/v1.20261003.0/src/src/batteries/llm/chat_common/types.ts#L547)           |
|  `renderRetrievableSafetyDirective`             | () => `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | Renders the safety directive that precedes any retrievable content.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | [`ChatHelpersCommon`](../../../openai_responses/interfaces/ChatHelpersCommon.md).[`renderRetrievableSafetyDirective`](../../../openai_responses/interfaces/ChatHelpersCommon.md#property-renderretrievablesafetydirective)             | [src/batteries/llm/chat\_common/types.ts:524](https://github.com/NHTIO/ADK/blob/v1.20261003.0/src/src/batteries/llm/chat_common/types.ts#L524)           |
|  `renderStandingInstructions`                         | (`items`: `Iterable`<[`Tokenizable`](../../../../../common/classes/Tokenizable.md)>, `attrs?`: [`StandingInstructionAttrs`](../../../../interfaces/StandingInstructionAttrs.md)) => `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | Renders standing instructions into a single prompt block.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | [`ChatHelpersCommon`](../../../openai_responses/interfaces/ChatHelpersCommon.md).[`renderStandingInstructions`](../../../openai_responses/interfaces/ChatHelpersCommon.md#property-renderstandinginstructions)                         | [src/batteries/llm/chat\_common/types.ts:517](https://github.com/NHTIO/ADK/blob/v1.20261003.0/src/src/batteries/llm/chat_common/types.ts#L517)           |
|  `renderThirdPartyPrivateRetrievables`       | (`items`: `Iterable`<{ `attrs`: [`RetrievableAttrs`](../../../../interfaces/RetrievableAttrs.md); `retrievable`: [`Retrievable`](../../../../../common/classes/Retrievable.md); }>, `deps`: { `renderRetrievableHandleBody?`: (`input`: { `artifact`: `unknown`; `byteLength`: `number`; `callId`: `string`; `encoding?`: `string`; `estimatedTokens?`: `number`; `lineCount`: `number`; }) => `string`; `renderUntrustedContent`: (`content`: `string`, `attrs`: [`UntrustedContentAttrs`](../../../../interfaces/UntrustedContentAttrs.md)) => `string`; }) => `Promise`<`string`>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | Renders third-party private retrievables, wrapping each in the untrusted-content envelope.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | [`ChatHelpersCommon`](../../../openai_responses/interfaces/ChatHelpersCommon.md).[`renderThirdPartyPrivateRetrievables`](../../../openai_responses/interfaces/ChatHelpersCommon.md#property-renderthirdpartyprivateretrievables)       | [src/batteries/llm/chat\_common/types.ts:539](https://github.com/NHTIO/ADK/blob/v1.20261003.0/src/src/batteries/llm/chat_common/types.ts#L539)           |
|  `renderThirdPartyPublicRetrievables`         | (`items`: `Iterable`<{ `attrs`: [`RetrievableAttrs`](../../../../interfaces/RetrievableAttrs.md); `retrievable`: [`Retrievable`](../../../../../common/classes/Retrievable.md); }>, `deps`: { `renderRetrievableHandleBody?`: (`input`: { `artifact`: `unknown`; `byteLength`: `number`; `callId`: `string`; `encoding?`: `string`; `estimatedTokens?`: `number`; `lineCount`: `number`; }) => `string`; `renderUntrustedContent`: (`content`: `string`, `attrs`: [`UntrustedContentAttrs`](../../../../interfaces/UntrustedContentAttrs.md)) => `string`; }) => `Promise`<`string`>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | Renders third-party public retrievables, wrapping each in the untrusted-content envelope.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | [`ChatHelpersCommon`](../../../openai_responses/interfaces/ChatHelpersCommon.md).[`renderThirdPartyPublicRetrievables`](../../../openai_responses/interfaces/ChatHelpersCommon.md#property-renderthirdpartypublicretrievables)         | [src/batteries/llm/chat\_common/types.ts:531](https://github.com/NHTIO/ADK/blob/v1.20261003.0/src/src/batteries/llm/chat_common/types.ts#L531)           |
|  `renderThought`                                                   | (`content`: `string`, `attrs`: [`ThoughtAttrs`](../../../../interfaces/ThoughtAttrs.md), `payload?`: `unknown`) => `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | Renders a single thought into its prompt block, optionally carrying an opaque replay payload.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | [`ChatHelpersCommon`](../../../openai_responses/interfaces/ChatHelpersCommon.md).[`renderThought`](../../../openai_responses/interfaces/ChatHelpersCommon.md#property-renderthought)                                                   | [src/batteries/llm/chat\_common/types.ts:597](https://github.com/NHTIO/ADK/blob/v1.20261003.0/src/src/batteries/llm/chat_common/types.ts#L597)           |
|  `renderTrustedContent`                                     | (`content`: `string`, `attrs`: [`TrustedContentAttrs`](../../../../interfaces/TrustedContentAttrs.md)) => `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | Wraps trusted (first-party) text in the trusted-content trust envelope.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | [`ChatHelpersCommon`](../../../openai_responses/interfaces/ChatHelpersCommon.md).[`renderTrustedContent`](../../../openai_responses/interfaces/ChatHelpersCommon.md#property-rendertrustedcontent)                                     | [src/batteries/llm/chat\_common/types.ts:515](https://github.com/NHTIO/ADK/blob/v1.20261003.0/src/src/batteries/llm/chat_common/types.ts#L515)           |
|  `renderUntrustedContent`                                 | (`content`: `string`, `attrs`: [`UntrustedContentAttrs`](../../../../interfaces/UntrustedContentAttrs.md)) => `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Wraps untrusted (third-party) text in the untrusted-content trust envelope.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | [`ChatHelpersCommon`](../../../openai_responses/interfaces/ChatHelpersCommon.md).[`renderUntrustedContent`](../../../openai_responses/interfaces/ChatHelpersCommon.md#property-renderuntrustedcontent)                                 | [src/batteries/llm/chat\_common/types.ts:513](https://github.com/NHTIO/ADK/blob/v1.20261003.0/src/src/batteries/llm/chat_common/types.ts#L513)           |
|  `toolsToChatCompletionsTools`                       | (`tools`: readonly ( | [`Tool`](../../../../../forge/classes/Tool.md)<[`SpooledArtifact`](../../../../../spooled_artifact/classes/SpooledArtifact.md)> | [`ArtifactTool`](../../../../../forge/classes/ArtifactTool.md))\[], `deps`: { `descriptionToChatCompletionsJsonSchema`: (`d`: [`DescriptionLike`](../../../../interfaces/DescriptionLike.md)) => [`JsonSchema`](../../../../interfaces/JsonSchema.md); }) => [`ChatCompletionsTool`](../../../../interfaces/ChatCompletionsTool.md)\[]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | Translates the tool registry into the function-tool wire array advertised to the model.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | [`ChatHelpersCommon`](../../../openai_responses/interfaces/ChatHelpersCommon.md).[`toolsToChatCompletionsTools`](../../../openai_responses/interfaces/ChatHelpersCommon.md#property-toolstochatcompletionstools)                       | [src/batteries/llm/chat\_common/types.ts:606](https://github.com/NHTIO/ADK/blob/v1.20261003.0/src/src/batteries/llm/chat_common/types.ts#L606)           |
|  `toolsToConverseTools`                                     | (`tools`: `Iterable`< | [`Tool`](../../../../../forge/classes/Tool.md)<[`SpooledArtifact`](../../../../../spooled_artifact/classes/SpooledArtifact.md)> | [`ArtifactTool`](../../../../../forge/classes/ArtifactTool.md)>) => [`ConverseToolSpec`](ConverseToolSpec.md)\[]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | ADK tools → native `toolConfig.tools`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | -                                                                                                                                                                                                                                      | [src/batteries/llm/bedrock\_converse/types.ts:236](https://github.com/NHTIO/ADK/blob/v1.20261003.0/src/src/batteries/llm/bedrock_converse/types.ts#L236) |
