Skip to content
2 min read · 477 words

@nhtio/adk/batteries/llm/claude_code_cli/helpers

Swappable translation helpers for rendering ADK state into the Claude Code CLI's -p prompt string and MCP tool-result content.

Remarks

The wire-shape-agnostic helpers (renderUntrustedContent, renderMemories, renderChatCompletionsSystemPrompt, toolsToChatCompletionsTools, …) are shared with every other Chat-family battery via ../chat_common/helpers and re-exported here under their original names. Only the battery-specific helpers are defined here: renderClaudeCodeCliTimelineMessage (plain text — no native image side-channel, unlike Ollama's images[]), renderClaudeCodeCliToolCallResult (the inbound-history counterpart to the outbound MCP-result rendering adapter.ts performs directly), and buildClaudeCodeCliPrompt (the top-level history-to-prompt assembler — a direct structural port of buildOllamaHistory's ordering, collapsed to a single joined string).

Variables

VariableDescription
defaultBuildClaudeCodeCliPromptDefault history assembler; alias of buildClaudeCodeCliPrompt.
defaultRenderClaudeCodeCliTimelineMessageDefault timeline-message renderer; alias of renderClaudeCodeCliTimelineMessage.
defaultRenderClaudeCodeCliToolCallResultDefault tool-call-result renderer; alias of renderClaudeCodeCliToolCallResult.

Functions

FunctionDescription
buildClaudeCodeCliPromptAssembles the complete history for a dispatch into ONE joined prompt string — a direct structural port of buildOllamaHistory's ordering (leading system-prompt block, then the timestamp-sorted timeline of messages/thoughts/tool-calls, then any trailing buckets after 'timeline' in bucketOrder), with the target shape collapsed from a message array to a single string, since this wire has one -p positional argument.
renderClaudeCodeCliTimelineMessageRenders a single timeline @nhtio/adk!Message into plain text for the -p prompt string — structurally identical to renderOllamaTimelineMessage's trust-envelope/identity logic, except every attachment routes through unsupportedMediaPolicy and is appended as text (the "v1 prompt is text-only" limitation).
renderClaudeCodeCliToolCallResultRender a completed @nhtio/adk!ToolCall's result to plain text for the INBOUND history direction (how a past tool call reads back into a subsequent dispatch's rendered prompt) — always a string, since the -p prompt has no structured-content channel. Media results are routed through the same text-only media renderer used by the timeline path.

References

defaultDescriptionToChatCompletionsJsonSchema

Re-exports defaultDescriptionToChatCompletionsJsonSchema


defaultFilterThoughts

Re-exports defaultFilterThoughts


defaultRenderArtifactHandleBody

Re-exports defaultRenderArtifactHandleBody


defaultRenderChatCompletionsSystemPrompt

Re-exports defaultRenderChatCompletionsSystemPrompt


defaultRenderFirstPartyRetrievables

Re-exports defaultRenderFirstPartyRetrievables


defaultRenderMemories

Re-exports defaultRenderMemories


defaultRenderRetrievableHandleBody

Re-exports defaultRenderRetrievableHandleBody


defaultRenderRetrievables

Re-exports defaultRenderRetrievables


defaultRenderRetrievableSafetyDirective

Re-exports defaultRenderRetrievableSafetyDirective


defaultRenderStandingInstructions

Re-exports defaultRenderStandingInstructions


defaultRenderThirdPartyPrivateRetrievables

Re-exports defaultRenderThirdPartyPrivateRetrievables


defaultRenderThirdPartyPublicRetrievables

Re-exports defaultRenderThirdPartyPublicRetrievables


defaultRenderThought

Re-exports defaultRenderThought


defaultRenderTrustedContent

Re-exports defaultRenderTrustedContent


defaultRenderUntrustedContent

Re-exports defaultRenderUntrustedContent


defaultToolsToChatCompletionsTools

Re-exports defaultToolsToChatCompletionsTools


descriptionToChatCompletionsJsonSchema

Re-exports descriptionToChatCompletionsJsonSchema


filterThoughts

Re-exports filterThoughts


looksLikeSpooledArtifact

Re-exports looksLikeSpooledArtifact


renderArtifactHandleBody

Re-exports renderArtifactHandleBody


renderChatCompletionsSystemPrompt

Re-exports renderChatCompletionsSystemPrompt


renderFirstPartyRetrievables

Re-exports renderFirstPartyRetrievables


renderMemories

Re-exports renderMemories


renderRetrievableHandleBody

Re-exports renderRetrievableHandleBody


renderRetrievables

Re-exports renderRetrievables


renderRetrievableSafetyDirective

Re-exports renderRetrievableSafetyDirective


renderStandingInstructions

Re-exports renderStandingInstructions


renderThirdPartyPrivateRetrievables

Re-exports renderThirdPartyPrivateRetrievables


renderThirdPartyPublicRetrievables

Re-exports renderThirdPartyPublicRetrievables


renderThought

Re-exports renderThought


renderTrustedContent

Re-exports renderTrustedContent


renderUntrustedContent

Re-exports renderUntrustedContent


toolsToChatCompletionsTools

Re-exports toolsToChatCompletionsTools