@nhtio/adk 1.20260609.1 → 1.20260610.0

package/batteries/llm/openai_chat_completions/helpers.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.cjs","names":[],"sources":["../../../../src/batteries/llm/openai_chat_completions/helpers.ts"],"sourcesContent":["/**\n * Swappable translation helpers for rendering ADK state into Chat Completions requests.\n *\n * @module @nhtio/adk/batteries/llm/openai_chat_completions/helpers\n *\n * @remarks\n * The swappable translation helpers that turn ADK primitives into OpenAI Chat Completions wire\n * shapes. Each helper is exported under its unprefixed name AND under a `default*` alias so\n * consumers can compose partial overrides. Helpers that compose other helpers receive their\n * dependents via explicit input arguments — never via module-level closure — so a swap at any\n * layer propagates correctly.\n *\n * The wire-shape-AGNOSTIC helpers (`renderUntrustedContent`, `renderMemories`,\n * `renderChatCompletionsSystemPrompt`, `toolsToChatCompletionsTools`, …) now live in the shared,\n * internal `../chat_common/helpers` submodule and are re-exported here under their original names\n * so every existing import keeps resolving. Only the OpenAI-WIRE-SPECIFIC helpers\n * (`renderTimelineMessage`, `renderChatCompletionsToolCallResult`, `buildChatCompletionsHistory`,\n * `createChatCompletionsToolCallDeltaAccumulator`) and the reasoning-field extractor are defined\n * here.\n */\n\nimport { Media } from '@nhtio/adk/common'\nimport { isInstanceOf } from '@nhtio/adk/guards'\nimport { E_UNSUPPORTED_MEDIA_MODALITY } from './exceptions'\nimport {\n  escapeXmlAttribute,\n  sanitiseNameField,\n  memoryToAttrs,\n  retrievableToAttrs,\n  renderTrustedContent,\n  renderUntrustedContent,\n} from '../chat_common/helpers'\nimport type { ChatHelpersCommon } from '../chat_common/types'\nimport type {\n  Tool,\n  ArtifactTool,\n  ToolRegistry,\n  Tokenizable,\n  Memory,\n  Message,\n  Thought,\n  ToolCall,\n  Retrievable,\n  SpooledArtifact,\n  MediaModalityHazard,\n  MediaStashEntry,\n} from '@nhtio/adk/common'\nimport type {\n  ChatCompletionsMessage,\n  ChatCompletionsContentBlock,\n  ChatCompletionsToolCallDelta,\n  ChatCompletionsToolCallDeltaAccumulator,\n  AssembledToolCall,\n  ChatCompletionsBucketOrder,\n  MemoryAttrs,\n  RetrievableAttrs,\n  ChatCompletionsHelpers,\n  UnsupportedMediaPolicy,\n  ReasoningField,\n  ReasoningFieldPrecedence,\n  ReasoningExtract,\n} from './types'\n\n// ─── Re-exported wire-shape-agnostic helpers (shared submodule) ───────────────\n// These are defined once in `../chat_common/helpers` and shared with the native Ollama battery.\n// Re-exported here (bare + `default*`) so every existing\n// `@nhtio/adk/batteries/llm/openai_chat_completions` import keeps resolving unchanged.\nexport {\n  descriptionToChatCompletionsJsonSchema,\n  defaultDescriptionToChatCompletionsJsonSchema,\n  renderUntrustedContent,\n  defaultRenderUntrustedContent,\n  renderTrustedContent,\n  defaultRenderTrustedContent,\n  renderStandingInstructions,\n  defaultRenderStandingInstructions,\n  renderMemories,\n  defaultRenderMemories,\n  renderRetrievableSafetyDirective,\n  defaultRenderRetrievableSafetyDirective,\n  renderFirstPartyRetrievables,\n  defaultRenderFirstPartyRetrievables,\n  renderThirdPartyPublicRetrievables,\n  defaultRenderThirdPartyPublicRetrievables,\n  renderThirdPartyPrivateRetrievables,\n  defaultRenderThirdPartyPrivateRetrievables,\n  renderRetrievables,\n  defaultRenderRetrievables,\n  renderThought,\n  defaultRenderThought,\n  filterThoughts,\n  defaultFilterThoughts,\n  toolsToChatCompletionsTools,\n  defaultToolsToChatCompletionsTools,\n  renderChatCompletionsSystemPrompt,\n  defaultRenderChatCompletionsSystemPrompt,\n} from '../chat_common/helpers'\n\n// ─── extractReasoningFields ───────────────────────────────────────────────────\n\n/**\n * Pulls model reasoning/thinking text out of a Chat Completions response message or stream delta,\n * reading every wire field named in `precedence` that carries a non-empty string.\n *\n * @remarks\n * Reasoning is not part of OpenAI's official Chat Completions spec, so OpenAI-compatible providers\n * disagree on the field name (`reasoning` for Ollama and current vLLM; `reasoning_content` for\n * legacy vLLM and DeepSeek). This reads the union, in `precedence` order, and de-duplicates by\n * content value: a field whose text exactly matches one already kept is dropped.\n *\n * The result length encodes the emission rule the callers follow:\n * - `0` — no reasoning present.\n * - `1` — a single thought (covers \"only one field present\" AND \"several present but identical\").\n * - `≥2` — divergent fields; each surfaces as its own thought rather than silently dropping one.\n *\n * @param src - The response `message` or stream `delta` to read from.\n * @param precedence - Ordered, de-duplicated field names to read (see `reasoningFieldPrecedence`).\n * @returns The present, content-deduplicated reasoning traces in precedence order.\n */\nexport const extractReasoningFields = (\n  src: Partial<Record<ReasoningField, string | null | undefined>> | undefined,\n  precedence: ReasoningFieldPrecedence\n): ReasoningExtract[] => {\n  const out: ReasoningExtract[] = []\n  for (const field of precedence) {\n    const value = src?.[field]\n    if (typeof value !== 'string' || value.length === 0) continue\n    if (out.some((e) => e.content === value)) continue\n    out.push({ field, content: value })\n  }\n  return out\n}\n\n// ─── Media rendering helpers (OpenAI content-block specific) ──────────────────\n\nconst DEFAULT_STASH_FALLBACK_KEYS: ReadonlyArray<string> = [\n  'text:transcript',\n  'text:caption',\n  'text:description',\n]\n\nconst modalityHazardToAttr = (h: MediaModalityHazard): 'inert' | 'extractable' | 'opaque' => {\n  if (h === 'inert') return 'inert'\n  if (h === 'extractable-instructions') return 'extractable'\n  return 'opaque'\n}\n\nconst formatBytesHumanReadable = (bytes: number | undefined): string => {\n  if (bytes === undefined || !Number.isFinite(bytes)) return 'unknown size'\n  if (bytes < 1024) return `${bytes} B`\n  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`\n  if (bytes < 1024 * 1024 * 1024) return `${(bytes / (1024 * 1024)).toFixed(1)} MB`\n  return `${(bytes / (1024 * 1024 * 1024)).toFixed(1)} GB`\n}\n\nconst audioFormatFromMime = (mime: string): 'wav' | 'mp3' | undefined => {\n  const m = mime.toLowerCase()\n  if (m.includes('wav') || m.includes('x-wav') || m.includes('wave')) return 'wav'\n  if (m.includes('mpeg') || m.includes('mp3')) return 'mp3'\n  return undefined\n}\n\nconst isMediaTextStashEntry = (e: unknown): e is MediaStashEntry => {\n  if (!e || typeof e !== 'object') return false\n  const r = e as Record<string, unknown>\n  return typeof r.value === 'string' && typeof r.trustTier === 'string'\n}\n\nconst resolveFallbackStash = (\n  media: Media,\n  keys: ReadonlyArray<string>\n): { text: string; entryTier: MediaStashEntry['trustTier'] } | undefined => {\n  for (const key of keys) {\n    const entry = media.stash.get(key)\n    if (isMediaTextStashEntry(entry)) {\n      return { text: entry.value as string, entryTier: entry.trustTier }\n    }\n  }\n  return undefined\n}\n\nconst renderTextInEnvelope = (\n  text: string,\n  args: {\n    trustTier: MediaStashEntry['trustTier']\n    modality: 'inert' | 'extractable' | 'opaque'\n    nonce: string\n    toolName: string | undefined\n    renderTrustedContent: ChatHelpersCommon['renderTrustedContent']\n    renderUntrustedContent: ChatHelpersCommon['renderUntrustedContent']\n  }\n): string => {\n  if (args.trustTier === 'first-party') {\n    return args.renderTrustedContent(text, {\n      nonce: args.nonce,\n      kind: 'media-fallback',\n      tool: args.toolName,\n      modality: args.modality,\n    })\n  }\n  return args.renderUntrustedContent(text, {\n    nonce: args.nonce,\n    kind: 'media-fallback',\n    tool: args.toolName,\n    modality: args.modality,\n  })\n}\n\nconst renderSyntheticMediaDescription = (media: Media, byteLen: number | undefined): string =>\n  `[media: ${media.filename}, ${media.mimeType}, ${formatBytesHumanReadable(byteLen)}]`\n\nconst renderMediaToContentBlocks = async (input: {\n  media: Media\n  toolName: string | undefined\n  nonce: string\n  unsupportedMediaPolicy: UnsupportedMediaPolicy\n  renderTrustedContent: ChatHelpersCommon['renderTrustedContent']\n  renderUntrustedContent: ChatHelpersCommon['renderUntrustedContent']\n  warn?: (msg: string) => void\n}): Promise<ChatCompletionsContentBlock[]> => {\n  const { media, toolName, nonce, unsupportedMediaPolicy, warn } = input\n  const modality = modalityHazardToAttr(media.modalityHazard)\n  const kind = media.kind\n\n  const fallbackPath = async (\n    keys: ReadonlyArray<string>,\n    allowSyntheticFallthrough: boolean\n  ): Promise<ChatCompletionsContentBlock[]> => {\n    const fallback = resolveFallbackStash(media, keys)\n    if (fallback) {\n      const text = renderTextInEnvelope(fallback.text, {\n        trustTier: fallback.entryTier,\n        modality,\n        nonce,\n        toolName,\n        renderTrustedContent: input.renderTrustedContent,\n        renderUntrustedContent: input.renderUntrustedContent,\n      })\n      return [{ type: 'text', text }]\n    }\n    if (!allowSyntheticFallthrough) {\n      // 'fallback-stash' falls through to 'synthetic-description' when no entry is found.\n      warn?.(\n        `unsupportedMediaPolicy='fallback-stash' for ${media.filename}: no matching stash entry — falling through to synthetic description.`\n      )\n    }\n    const byteLen = await media.byteLength()\n    const text = renderTextInEnvelope(renderSyntheticMediaDescription(media, byteLen), {\n      trustTier: media.trustTier,\n      modality,\n      nonce,\n      toolName,\n      renderTrustedContent: input.renderTrustedContent,\n      renderUntrustedContent: input.renderUntrustedContent,\n    })\n    return [{ type: 'text', text }]\n  }\n\n  if (kind === 'image') {\n    const b64 = await media.asBase64()\n    return [\n      {\n        type: 'image_url',\n        image_url: { url: `data:${media.mimeType};base64,${b64}` },\n      },\n    ]\n  }\n\n  if (kind === 'audio') {\n    const fmt = audioFormatFromMime(media.mimeType)\n    if (fmt === undefined) {\n      // Audio mime not natively expressible — same policy path as video.\n      if (unsupportedMediaPolicy === 'throw') {\n        throw new E_UNSUPPORTED_MEDIA_MODALITY([media.kind, media.mimeType, media.filename])\n      }\n      if (\n        unsupportedMediaPolicy === 'fallback-stash' ||\n        (typeof unsupportedMediaPolicy === 'object' &&\n          unsupportedMediaPolicy.mode === 'fallback-stash')\n      ) {\n        const keys =\n          typeof unsupportedMediaPolicy === 'object'\n            ? unsupportedMediaPolicy.stashKeys\n            : DEFAULT_STASH_FALLBACK_KEYS\n        return fallbackPath(keys, false)\n      }\n      return fallbackPath([], true)\n    }\n    const data = await media.asBase64()\n    return [\n      {\n        type: 'input_audio',\n        input_audio: { data, format: fmt },\n      },\n    ]\n  }\n\n  if (kind === 'document') {\n    const b64 = await media.asBase64()\n    return [\n      {\n        type: 'file',\n        file: {\n          filename: media.filename,\n          file_data: `data:${media.mimeType};base64,${b64}`,\n        },\n      },\n    ]\n  }\n\n  // kind === 'video' — not natively supported by Chat Completions wire format.\n  if (unsupportedMediaPolicy === 'throw') {\n    throw new E_UNSUPPORTED_MEDIA_MODALITY([media.kind, media.mimeType, media.filename])\n  }\n  if (\n    unsupportedMediaPolicy === 'fallback-stash' ||\n    (typeof unsupportedMediaPolicy === 'object' && unsupportedMediaPolicy.mode === 'fallback-stash')\n  ) {\n    const keys =\n      typeof unsupportedMediaPolicy === 'object'\n        ? unsupportedMediaPolicy.stashKeys\n        : DEFAULT_STASH_FALLBACK_KEYS\n    return fallbackPath(keys, false)\n  }\n  return fallbackPath([], true)\n}\n\n// ─── renderTimelineMessage ────────────────────────────────────────────────────\n\n/**\n * Renders a single timeline {@link @nhtio/adk!Message} into an OpenAI Chat Completions message —\n * mapping media to content blocks (`image_url` / `input_audio` / `file`), wrapping textual bodies\n * in the appropriate trust envelope, and applying the unsupported-media policy.\n */\nexport const renderTimelineMessage = async (input: {\n  message: Message\n  selfIdentity: string\n  unsupportedMediaPolicy: UnsupportedMediaPolicy\n  warn?: (msg: string) => void\n}): Promise<ChatCompletionsMessage> => {\n  const { message, selfIdentity, unsupportedMediaPolicy, warn } = input\n  const identifier =\n    message.identity?.identifier !== undefined && message.identity?.identifier !== null\n      ? String(message.identity.identifier)\n      : ''\n  const representationRaw =\n    message.identity?.representation !== undefined && message.identity?.representation !== null\n      ? message.identity.representation.toString()\n      : ''\n  // Prompt-facing identity (the `from=` attribute) reads `representation`;\n  // structural `messages[].name` reads `identifier`. Fall back to `identifier`\n  // when `representation` is empty so a bare-string identity still renders.\n  const representation = representationRaw.length > 0 ? representationRaw : identifier\n  const text = message.content !== undefined ? message.content.toString() : ''\n  const createdAtStr = message.createdAt.toISO?.() ?? ''\n  const createdAtAttr = createdAtStr ? ` createdAt=\"${escapeXmlAttribute(createdAtStr)}\"` : ''\n  const attachments = message.attachments\n  const hasAttachments = attachments.length > 0\n\n  // Build the text envelope first (same logic as before).\n  let envelopeText: string\n  let nameField: string | undefined\n  let role: 'user' | 'assistant'\n  if (message.role === 'user') {\n    role = 'user'\n    if (identifier.length === 0) {\n      envelopeText = text\n    } else {\n      nameField = sanitiseNameField(identifier)\n      const fromAttr = escapeXmlAttribute(representation)\n      envelopeText = `<message_${message.id} from=\"${fromAttr}\" role=\"user\"${createdAtAttr}>\\n${text}\\n</message_${message.id}>`\n    }\n  } else {\n    role = 'assistant'\n    if (identifier.length === 0 || identifier === selfIdentity) {\n      if (identifier.length > 0) {\n        nameField = sanitiseNameField(identifier)\n      }\n      envelopeText = text\n    } else {\n      nameField = sanitiseNameField(identifier)\n      const fromAttr = escapeXmlAttribute(representation)\n      envelopeText = `<peer_agent_output_${message.id} from=\"${fromAttr}\"${createdAtAttr}>\\n${text}\\n</peer_agent_output_${message.id}>`\n    }\n  }\n\n  if (!hasAttachments) {\n    const out: ChatCompletionsMessage = { role, content: envelopeText }\n    if (nameField !== undefined) out.name = nameField\n    return out\n  }\n\n  // Content-array path: text first (when present), then attachment blocks in array order.\n  const blocks: ChatCompletionsContentBlock[] = []\n  if (text.length > 0) {\n    blocks.push({ type: 'text', text: envelopeText })\n  }\n  for (const media of attachments) {\n    const mediaBlocks = await renderMediaToContentBlocks({\n      media,\n      toolName: undefined,\n      nonce: message.id,\n      unsupportedMediaPolicy,\n      renderTrustedContent,\n      renderUntrustedContent,\n      warn,\n    })\n    for (const b of mediaBlocks) blocks.push(b)\n  }\n  const out: ChatCompletionsMessage = { role, content: blocks }\n  if (nameField !== undefined) out.name = nameField\n  return out\n}\n/** Default timeline-message renderer; alias of {@link renderTimelineMessage}. */\nexport const defaultRenderTimelineMessage = renderTimelineMessage\n\n// ─── renderChatCompletionsToolCallResult ──────────────────────────────────────\n\nconst isSpooledArtifactResult = (\n  results: SpooledArtifact | Tokenizable\n): results is SpooledArtifact =>\n  isInstanceOf(results, 'SpooledArtifact') ||\n  // Subclasses identify via the base class guard upstream\n  ((results as unknown as { constructor?: { isSpooledArtifactConstructor?: boolean } })\n    ?.constructor !== null &&\n    (results as unknown as { constructor?: { isSpooledArtifactConstructor?: boolean } })\n      ?.constructor !== undefined &&\n    typeof (\n      results as unknown as {\n        constructor: { isSpooledArtifactConstructor?: (c: unknown) => boolean }\n      }\n    ).constructor.isSpooledArtifactConstructor === 'function')\n\nconst looksLikeSpooledArtifact = (value: unknown): value is SpooledArtifact => {\n  if (!value || typeof value !== 'object') return false\n  const v = value as Record<string, unknown>\n  return (\n    typeof v.asString === 'function' &&\n    typeof v.byteLength === 'function' &&\n    typeof v.lineCount === 'function' &&\n    typeof v.estimateTokens === 'function'\n  )\n}\n\nconst renderArtifactHandleBody = (\n  toolCall: ToolCall,\n  artifact: SpooledArtifact,\n  byteLength: number,\n  lineCount: number,\n  estimatedTokens: number | undefined,\n  encoding: string | undefined\n): string => {\n  const ctor = (\n    artifact as unknown as {\n      constructor: { toolMethods?: ReadonlyArray<{ name: string; description?: string }> }\n    }\n  ).constructor\n  const methods = ctor?.toolMethods ?? []\n  const lines: string[] = []\n  lines.push(`This tool returned a large artifact that was not inlined to preserve context budget.`)\n  lines.push(``)\n  lines.push(`Artifact metadata:`)\n  lines.push(`- callId: ${toolCall.id}`)\n  lines.push(`- kind: ${ctor?.constructor?.name ?? 'SpooledArtifact'}`)\n  lines.push(`- byteLength: ${byteLength}`)\n  lines.push(`- lineCount: ${lineCount}`)\n  if (estimatedTokens !== undefined && encoding) {\n    lines.push(`- estimatedTokens: ${estimatedTokens} (encoding: ${encoding})`)\n  }\n  lines.push(``)\n  lines.push(`To read this artifact in this turn, call one of the following tools with`)\n  lines.push(`callId=${toolCall.id}:`)\n  for (const m of methods) {\n    if (m.description) {\n      lines.push(`- ${m.name} — ${m.description}`)\n    } else {\n      lines.push(`- ${m.name}`)\n    }\n  }\n  lines.push(``)\n  lines.push(\n    `The artifact persists in this turn's context — multiple queries against the same callId are allowed and efficient. Do not assume the body has been inlined anywhere else.`\n  )\n  return lines.join('\\n')\n}\n\n/**\n * Renders a tool call's result(s) into the OpenAI Chat Completions tool-message body — either a\n * plain string or an array of content blocks when the result carries media — wrapping textual\n * output in the trust envelope appropriate to the tool's trust level.\n */\nexport const renderChatCompletionsToolCallResult = async (input: {\n  toolCall: ToolCall\n  results: Tokenizable | SpooledArtifact | SpooledArtifact[] | Media | Media[]\n  tool: Tool | ArtifactTool | undefined\n  renderUntrustedContent: ChatHelpersCommon['renderUntrustedContent']\n  renderTrustedContent: ChatHelpersCommon['renderTrustedContent']\n  unsupportedMediaPolicy: UnsupportedMediaPolicy\n  warn?: (msg: string) => void\n}): Promise<string | ChatCompletionsContentBlock[]> => {\n  const { toolCall, results, tool, warn, unsupportedMediaPolicy } = input\n  const isTrusted =\n    tool !== null && tool !== undefined && (tool as { trusted?: boolean }).trusted === true\n\n  if (tool === undefined) {\n    warn?.(\n      `Tool \"${toolCall.tool}\" is not present in the bound tool registry at render time; defaulting to untrusted envelope.`\n    )\n  }\n\n  // Media / Media[] silo — bypasses Tool.trusted (Trust-Is-Content rule). Envelope is sourced\n  // from each Media's own trustTier; modality from each Media's modalityHazard.\n  const isMediaResult = Media.isMedia(results)\n  const isMediaArrayResult =\n    Array.isArray(results) && results.length > 0 && results.every((r) => Media.isMedia(r))\n  if (isMediaResult || isMediaArrayResult) {\n    const mediaList = isMediaResult ? [results as Media] : (results as Media[])\n    const blocks: ChatCompletionsContentBlock[] = []\n    for (const media of mediaList) {\n      const mediaBlocks = await renderMediaToContentBlocks({\n        media,\n        toolName: toolCall.tool,\n        nonce: toolCall.checksum,\n        unsupportedMediaPolicy,\n        renderTrustedContent: input.renderTrustedContent,\n        renderUntrustedContent: input.renderUntrustedContent,\n        warn,\n      })\n      for (const b of mediaBlocks) blocks.push(b)\n    }\n    return blocks\n  }\n\n  // SpooledArtifact[] silo — render each artifact through the existing single-artifact path\n  // and concatenate the bodies. Trust envelope is decided per-artifact via the surrounding\n  // Tool.trusted flag (same as single SpooledArtifact today).\n  if (Array.isArray(results)) {\n    const parts: string[] = []\n    for (const a of results) {\n      const body = await (a as SpooledArtifact).asString()\n      parts.push(body)\n    }\n    const joined = parts.join('\\n\\n')\n    if (isTrusted) {\n      return input.renderTrustedContent(joined, {\n        nonce: toolCall.checksum,\n        kind: 'trusted-tool-result',\n        tool: toolCall.tool,\n      })\n    }\n    return input.renderUntrustedContent(joined, {\n      nonce: toolCall.checksum,\n      kind: 'tool-result',\n      tool: toolCall.tool,\n    })\n  }\n\n  const isSpooled = looksLikeSpooledArtifact(results)\n\n  // Handle-pattern branch: spooled + inline=false → always untrusted (queryable-data, not policy).\n  if (isSpooled && toolCall.inline === false) {\n    const artifact = results as SpooledArtifact\n    let byteLength = 0\n    let lineCount = 0\n    try {\n      byteLength = await artifact.byteLength()\n    } catch {\n      byteLength = 0\n    }\n    try {\n      lineCount = await artifact.lineCount()\n    } catch {\n      lineCount = 0\n    }\n    const body = renderArtifactHandleBody(\n      toolCall,\n      artifact,\n      byteLength,\n      lineCount,\n      undefined,\n      undefined\n    )\n    return input.renderUntrustedContent(body, {\n      nonce: toolCall.checksum,\n      kind: 'artifact-handle',\n      tool: toolCall.tool,\n    })\n  }\n\n  // Inline path: render full body via the appropriate envelope.\n  if (!isSpooled && toolCall.inline === false) {\n    warn?.(\n      `Tool call ${toolCall.id} has inline=false but results is a Tokenizable (not a SpooledArtifact); rendering inline anyway.`\n    )\n  }\n\n  let body: string\n  if (isSpooled) {\n    body = await (results as SpooledArtifact).asString()\n  } else {\n    body = (results as Tokenizable).toString()\n  }\n\n  if (isTrusted) {\n    return input.renderTrustedContent(body, {\n      nonce: toolCall.checksum,\n      kind: 'trusted-tool-result',\n      tool: toolCall.tool,\n    })\n  }\n  return input.renderUntrustedContent(body, {\n    nonce: toolCall.checksum,\n    kind: 'tool-result',\n    tool: toolCall.tool,\n  })\n}\n/** Default tool-call-result renderer; alias of {@link renderChatCompletionsToolCallResult}. */\nexport const defaultRenderChatCompletionsToolCallResult = renderChatCompletionsToolCallResult\n\n// suppress unused; kept for forward-compat with stricter spool guards\nvoid isSpooledArtifactResult\n\n// ─── buildChatCompletionsHistory ──────────────────────────────────────────────\n\ntype TimelineItem =\n  | { kind: 'message'; createdAt: number; value: Message }\n  | { kind: 'thought'; createdAt: number; value: Thought }\n  | { kind: 'toolCall'; createdAt: number; value: ToolCall }\n\n/**\n * Assembles the complete OpenAI Chat Completions message history for a dispatch — system prompt and\n * content buckets, the interleaved timeline of messages/thoughts/tool calls (with synthetic\n * `assistant.tool_calls` and `tool.tool_call_id` shaping), and the collected opaque reasoning\n * payloads — by delegating to the injected sub-renderers.\n */\nexport const buildChatCompletionsHistory = async (input: {\n  systemPrompt: Tokenizable\n  standingInstructions: Iterable<Tokenizable>\n  memories: Iterable<Memory>\n  retrievables: Iterable<Retrievable>\n  messages: Iterable<Message>\n  thoughts: Iterable<Thought>\n  toolCalls: Iterable<ToolCall>\n  tools: ToolRegistry\n  renderedToolCallResults: Map<string, string | ChatCompletionsContentBlock[]>\n  bucketOrder: ChatCompletionsBucketOrder\n  selfIdentity: string\n  thoughtSurfacing: 'all-self' | 'latest-self' | 'all'\n  replayCompatibility: ReadonlyArray<string>\n  unsupportedMediaPolicy: UnsupportedMediaPolicy\n  renderChatCompletionsToolCallResult: ChatCompletionsHelpers['renderChatCompletionsToolCallResult']\n  renderChatCompletionsSystemPrompt: ChatHelpersCommon['renderChatCompletionsSystemPrompt']\n  renderStandingInstructions: ChatHelpersCommon['renderStandingInstructions']\n  renderMemories: ChatHelpersCommon['renderMemories']\n  renderRetrievables: ChatHelpersCommon['renderRetrievables']\n  renderRetrievableSafetyDirective: ChatHelpersCommon['renderRetrievableSafetyDirective']\n  renderFirstPartyRetrievables: ChatHelpersCommon['renderFirstPartyRetrievables']\n  renderThirdPartyPublicRetrievables: ChatHelpersCommon['renderThirdPartyPublicRetrievables']\n  renderThirdPartyPrivateRetrievables: ChatHelpersCommon['renderThirdPartyPrivateRetrievables']\n  renderTimelineMessage: ChatCompletionsHelpers['renderTimelineMessage']\n  renderThought: ChatHelpersCommon['renderThought']\n  filterThoughts: ChatHelpersCommon['filterThoughts']\n  renderUntrustedContent: ChatHelpersCommon['renderUntrustedContent']\n  renderTrustedContent: ChatHelpersCommon['renderTrustedContent']\n  warn?: (msg: string) => void\n}): Promise<{\n  messages: ChatCompletionsMessage[]\n  reasoningPayloads: Array<{ id: string; replayCompatibility: string; payload: unknown }>\n}> => {\n  const out: ChatCompletionsMessage[] = []\n  const reasoningPayloads: Array<{\n    id: string\n    replayCompatibility: string\n    payload: unknown\n  }> = []\n\n  const buckets = input.bucketOrder\n  const timelineIdx = buckets.indexOf('timeline')\n\n  // Build leading system content from base prompt + before-timeline buckets.\n  const leadingSystem = await input.renderChatCompletionsSystemPrompt({\n    systemPrompt: input.systemPrompt,\n    standingInstructions: input.standingInstructions,\n    memories: input.memories,\n    retrievables: input.retrievables,\n    bucketOrder: buckets,\n    renderStandingInstructions: input.renderStandingInstructions,\n    renderMemories: input.renderMemories,\n    renderRetrievables: input.renderRetrievables,\n    renderRetrievableSafetyDirective: input.renderRetrievableSafetyDirective,\n    renderFirstPartyRetrievables: input.renderFirstPartyRetrievables,\n    renderThirdPartyPublicRetrievables: input.renderThirdPartyPublicRetrievables,\n    renderThirdPartyPrivateRetrievables: input.renderThirdPartyPrivateRetrievables,\n    renderUntrustedContent: input.renderUntrustedContent,\n  })\n  if (leadingSystem.length > 0) {\n    out.push({ role: 'system', content: leadingSystem })\n  }\n\n  // Build the timeline (if present in bucketOrder).\n  const includesTimeline = timelineIdx !== -1\n  if (includesTimeline) {\n    // Filter thoughts per surfacing mode + compatibility.\n    const survivingThoughts = input.filterThoughts(\n      input.thoughts,\n      input.thoughtSurfacing,\n      input.selfIdentity,\n      input.replayCompatibility\n    )\n\n    // Build sorted timeline items.\n    const items: TimelineItem[] = []\n    for (const m of input.messages) {\n      items.push({ kind: 'message', createdAt: m.createdAt.toMillis(), value: m })\n    }\n    for (const t of survivingThoughts) {\n      items.push({ kind: 'thought', createdAt: t.createdAt.toMillis(), value: t })\n    }\n    for (const tc of input.toolCalls) {\n      items.push({ kind: 'toolCall', createdAt: tc.createdAt.toMillis(), value: tc })\n    }\n    items.sort((a, b) => a.createdAt - b.createdAt)\n\n    const replaySet = new Set<string>([...input.replayCompatibility])\n\n    for (const item of items) {\n      if (item.kind === 'message') {\n        out.push(\n          await input.renderTimelineMessage({\n            message: item.value,\n            selfIdentity: input.selfIdentity,\n            unsupportedMediaPolicy: input.unsupportedMediaPolicy,\n            warn: input.warn,\n          })\n        )\n      } else if (item.kind === 'thought') {\n        const t = item.value\n        const identifier = String(t.identity?.identifier ?? '')\n        const isSelf = identifier === input.selfIdentity\n        const hasPayload = t.payload !== undefined\n        const compatTag = t.replayCompatibility\n\n        if (hasPayload && compatTag && replaySet.has(compatTag)) {\n          // Opaque reasoning — side-channel + summary envelope.\n          reasoningPayloads.push({\n            id: t.id,\n            replayCompatibility: compatTag,\n            payload: t.payload,\n          })\n          const envelope = input.renderThought(\n            t.content.toString(),\n            {\n              nonce: t.id,\n              kind: 'opaque-reasoning',\n              from: identifier,\n              createdAt: t.createdAt?.toISO?.() ?? undefined,\n              replayCompatibility: compatTag,\n            },\n            t.payload\n          )\n          const synthetic: ChatCompletionsMessage = {\n            role: 'assistant',\n            content: envelope,\n          }\n          if (!isSelf && identifier.length > 0) {\n            synthetic.name = sanitiseNameField(identifier)\n          }\n          out.push(synthetic)\n        } else if (!hasPayload) {\n          // Plain-text reasoning (no payload, or tagged plain-text, or tagged but matched).\n          const envelope = input.renderThought(t.content.toString(), {\n            nonce: t.id,\n            kind: isSelf ? 'self-reasoning' : 'peer-reasoning',\n            from: identifier,\n            createdAt: t.createdAt?.toISO?.() ?? undefined,\n          })\n          const synthetic: ChatCompletionsMessage = {\n            role: 'assistant',\n            content: envelope,\n          }\n          if (!isSelf && identifier.length > 0) {\n            synthetic.name = sanitiseNameField(identifier)\n          }\n          out.push(synthetic)\n        }\n        // else: opaque, non-matching → elided (NOT removed from ctx.turnThoughts upstream).\n      } else {\n        // tool call: emit a synthetic assistant message carrying tool_calls[],\n        // followed by a tool-role message with the result.\n        const tc = item.value\n        const assistantMsg: ChatCompletionsMessage = {\n          role: 'assistant',\n          content: null,\n          tool_calls: [\n            {\n              id: tc.id,\n              type: 'function',\n              function: {\n                name: tc.tool,\n                arguments: typeof tc.args === 'string' ? tc.args : JSON.stringify(tc.args ?? {}),\n              },\n            },\n          ],\n        }\n        out.push(assistantMsg)\n\n        let rendered = input.renderedToolCallResults.get(tc.id)\n        if (rendered === undefined) {\n          const tool = input.tools.get?.(tc.tool)\n          rendered = await input.renderChatCompletionsToolCallResult({\n            toolCall: tc,\n            results: tc.results as\n              | Tokenizable\n              | SpooledArtifact\n              | SpooledArtifact[]\n              | Media\n              | Media[],\n            tool: tool as Tool | ArtifactTool | undefined,\n            renderUntrustedContent: input.renderUntrustedContent,\n            renderTrustedContent: input.renderTrustedContent,\n            unsupportedMediaPolicy: input.unsupportedMediaPolicy,\n            warn: input.warn,\n          })\n        }\n        out.push({\n          role: 'tool',\n          content: rendered,\n          tool_call_id: tc.id,\n        })\n      }\n    }\n  }\n\n  // Trailing system message for after-timeline buckets.\n  if (includesTimeline) {\n    const trailingParts: string[] = []\n    for (let i = timelineIdx + 1; i < buckets.length; i++) {\n      const label = buckets[i]!\n      if (label === 'standingInstructions') {\n        const block = input.renderStandingInstructions(input.standingInstructions)\n        if (block.length > 0) trailingParts.push(block)\n      } else if (label === 'memories') {\n        const wrapped: Array<{ memory: Memory; attrs: MemoryAttrs }> = []\n        for (const m of input.memories) {\n          wrapped.push(memoryToAttrs(m))\n        }\n        const block = input.renderMemories(wrapped)\n        if (block.length > 0) trailingParts.push(block)\n      } else if (label === 'retrievables') {\n        const wrapped: Array<{ retrievable: Retrievable; attrs: RetrievableAttrs }> = []\n        for (const r of input.retrievables) {\n          wrapped.push(retrievableToAttrs(r))\n        }\n        const block = await input.renderRetrievables(wrapped, {\n          renderRetrievableSafetyDirective: input.renderRetrievableSafetyDirective,\n          renderFirstPartyRetrievables: input.renderFirstPartyRetrievables,\n          renderThirdPartyPublicRetrievables: input.renderThirdPartyPublicRetrievables,\n          renderThirdPartyPrivateRetrievables: input.renderThirdPartyPrivateRetrievables,\n          renderUntrustedContent: input.renderUntrustedContent,\n        })\n        if (block.length > 0) trailingParts.push(block)\n      }\n    }\n    if (trailingParts.length > 0) {\n      out.push({ role: 'system', content: trailingParts.join('\\n\\n') })\n    }\n  }\n\n  return { messages: out, reasoningPayloads }\n}\n/** Default history assembler; alias of {@link buildChatCompletionsHistory}. */\nexport const defaultBuildChatCompletionsHistory = buildChatCompletionsHistory\n\n// ─── createChatCompletionsToolCallDeltaAccumulator ────────────────────────────\n\n/**\n * Creates a fresh accumulator that stitches streamed {@link ChatCompletionsToolCallDelta} fragments\n * (keyed by their stream index) into fully-assembled tool calls, drained once the stream completes.\n */\nexport const createChatCompletionsToolCallDeltaAccumulator =\n  (): ChatCompletionsToolCallDeltaAccumulator => {\n    const byIndex = new Map<\n      number,\n      { id?: string; type?: 'function'; name: string; args: string }\n    >()\n    return {\n      feed(delta: ChatCompletionsToolCallDelta): void {\n        const idx = delta.index\n        let entry = byIndex.get(idx)\n        if (!entry) {\n          entry = { name: '', args: '' }\n          byIndex.set(idx, entry)\n        }\n        if (delta.id !== undefined) entry.id = delta.id\n        if (delta.type !== undefined) entry.type = delta.type\n        if (delta.function?.name !== undefined) {\n          entry.name = entry.name + delta.function.name\n        }\n        if (delta.function?.arguments !== undefined) {\n          entry.args = entry.args + delta.function.arguments\n        }\n      },\n      drain(): AssembledToolCall[] {\n        const out: AssembledToolCall[] = []\n        const indices = Array.from(byIndex.keys()).sort((a, b) => a - b)\n        for (const idx of indices) {\n          const e = byIndex.get(idx)!\n          out.push({\n            id: e.id ?? `call_${idx}`,\n            type: e.type ?? 'function',\n            name: e.name,\n            args: e.args,\n          })\n        }\n        return out\n      },\n    }\n  }\n/** Default delta-accumulator factory; alias of {@link createChatCompletionsToolCallDeltaAccumulator}. */\nexport const defaultCreateChatCompletionsToolCallDeltaAccumulator =\n  createChatCompletionsToolCallDeltaAccumulator\n"],"mappings":"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"}
+{"version":3,"file":"helpers.cjs","names":[],"sources":["../../../../src/batteries/llm/openai_chat_completions/helpers.ts"],"sourcesContent":["/**\n * Swappable translation helpers for rendering ADK state into Chat Completions requests.\n *\n * @module @nhtio/adk/batteries/llm/openai_chat_completions/helpers\n *\n * @remarks\n * The swappable translation helpers that turn ADK primitives into OpenAI Chat Completions wire\n * shapes. Each helper is exported under its unprefixed name AND under a `default*` alias so\n * consumers can compose partial overrides. Helpers that compose other helpers receive their\n * dependents via explicit input arguments — never via module-level closure — so a swap at any\n * layer propagates correctly.\n *\n * The wire-shape-AGNOSTIC helpers (`renderUntrustedContent`, `renderMemories`,\n * `renderChatCompletionsSystemPrompt`, `toolsToChatCompletionsTools`, …) now live in the shared,\n * internal `../chat_common/helpers` submodule and are re-exported here under their original names\n * so every existing import keeps resolving. Only the OpenAI-WIRE-SPECIFIC helpers\n * (`renderTimelineMessage`, `renderChatCompletionsToolCallResult`, `buildChatCompletionsHistory`,\n * `createChatCompletionsToolCallDeltaAccumulator`) and the reasoning-field extractor are defined\n * here.\n */\n\nimport { Media } from '@nhtio/adk/common'\nimport { isInstanceOf } from '@nhtio/adk/guards'\nimport { E_UNSUPPORTED_MEDIA_MODALITY } from './exceptions'\nimport {\n  escapeXmlAttribute,\n  sanitiseNameField,\n  memoryToAttrs,\n  retrievableToAttrs,\n  renderTrustedContent,\n  renderUntrustedContent,\n} from '../chat_common/helpers'\nimport type { ChatHelpersCommon } from '../chat_common/types'\nimport type {\n  Tool,\n  ArtifactTool,\n  ToolRegistry,\n  Tokenizable,\n  Memory,\n  Message,\n  Thought,\n  ToolCall,\n  Retrievable,\n  SpooledArtifact,\n  MediaModalityHazard,\n  MediaStashEntry,\n} from '@nhtio/adk/common'\nimport type {\n  ChatCompletionsMessage,\n  ChatCompletionsContentBlock,\n  ChatCompletionsToolCallDelta,\n  ChatCompletionsToolCallDeltaAccumulator,\n  AssembledToolCall,\n  ChatCompletionsBucketOrder,\n  MemoryAttrs,\n  RetrievableAttrs,\n  ChatCompletionsHelpers,\n  UnsupportedMediaPolicy,\n  ReasoningField,\n  ReasoningFieldPrecedence,\n  ReasoningExtract,\n} from './types'\n\n// ─── Re-exported wire-shape-agnostic helpers (shared submodule) ───────────────\n// These are defined once in `../chat_common/helpers` and shared with the native Ollama battery.\n// Re-exported here (bare + `default*`) so every existing\n// `@nhtio/adk/batteries/llm/openai_chat_completions` import keeps resolving unchanged.\nexport {\n  descriptionToChatCompletionsJsonSchema,\n  defaultDescriptionToChatCompletionsJsonSchema,\n  renderUntrustedContent,\n  defaultRenderUntrustedContent,\n  renderTrustedContent,\n  defaultRenderTrustedContent,\n  renderStandingInstructions,\n  defaultRenderStandingInstructions,\n  renderMemories,\n  defaultRenderMemories,\n  renderRetrievableSafetyDirective,\n  defaultRenderRetrievableSafetyDirective,\n  renderFirstPartyRetrievables,\n  defaultRenderFirstPartyRetrievables,\n  renderThirdPartyPublicRetrievables,\n  defaultRenderThirdPartyPublicRetrievables,\n  renderThirdPartyPrivateRetrievables,\n  defaultRenderThirdPartyPrivateRetrievables,\n  renderRetrievables,\n  defaultRenderRetrievables,\n  renderThought,\n  defaultRenderThought,\n  filterThoughts,\n  defaultFilterThoughts,\n  toolsToChatCompletionsTools,\n  defaultToolsToChatCompletionsTools,\n  renderChatCompletionsSystemPrompt,\n  defaultRenderChatCompletionsSystemPrompt,\n} from '../chat_common/helpers'\n\n// ─── extractReasoningFields ───────────────────────────────────────────────────\n\n/**\n * Pulls model reasoning/thinking text out of a Chat Completions response message or stream delta,\n * reading every wire field named in `precedence` that carries a non-empty string.\n *\n * @remarks\n * Reasoning is not part of OpenAI's official Chat Completions spec, so OpenAI-compatible providers\n * disagree on the field name (`reasoning` for Ollama and current vLLM; `reasoning_content` for\n * legacy vLLM and DeepSeek). This reads the union, in `precedence` order, and de-duplicates by\n * content value: a field whose text exactly matches one already kept is dropped.\n *\n * The result length encodes the emission rule the callers follow:\n * - `0` — no reasoning present.\n * - `1` — a single thought (covers \"only one field present\" AND \"several present but identical\").\n * - `≥2` — divergent fields; each surfaces as its own thought rather than silently dropping one.\n *\n * @param src - The response `message` or stream `delta` to read from.\n * @param precedence - Ordered, de-duplicated field names to read (see `reasoningFieldPrecedence`).\n * @returns The present, content-deduplicated reasoning traces in precedence order.\n */\nexport const extractReasoningFields = (\n  src: Partial<Record<ReasoningField, string | null | undefined>> | undefined,\n  precedence: ReasoningFieldPrecedence\n): ReasoningExtract[] => {\n  const out: ReasoningExtract[] = []\n  for (const field of precedence) {\n    const value = src?.[field]\n    if (typeof value !== 'string' || value.length === 0) continue\n    if (out.some((e) => e.content === value)) continue\n    out.push({ field, content: value })\n  }\n  return out\n}\n\n// ─── Media rendering helpers (OpenAI content-block specific) ──────────────────\n\nconst DEFAULT_STASH_FALLBACK_KEYS: ReadonlyArray<string> = [\n  'text:transcript',\n  'text:caption',\n  'text:description',\n]\n\nconst modalityHazardToAttr = (h: MediaModalityHazard): 'inert' | 'extractable' | 'opaque' => {\n  if (h === 'inert') return 'inert'\n  if (h === 'extractable-instructions') return 'extractable'\n  return 'opaque'\n}\n\nconst formatBytesHumanReadable = (bytes: number | undefined): string => {\n  if (bytes === undefined || !Number.isFinite(bytes)) return 'unknown size'\n  if (bytes < 1024) return `${bytes} B`\n  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`\n  if (bytes < 1024 * 1024 * 1024) return `${(bytes / (1024 * 1024)).toFixed(1)} MB`\n  return `${(bytes / (1024 * 1024 * 1024)).toFixed(1)} GB`\n}\n\nconst audioFormatFromMime = (mime: string): 'wav' | 'mp3' | undefined => {\n  const m = mime.toLowerCase()\n  if (m.includes('wav') || m.includes('x-wav') || m.includes('wave')) return 'wav'\n  if (m.includes('mpeg') || m.includes('mp3')) return 'mp3'\n  return undefined\n}\n\nconst isMediaTextStashEntry = (e: unknown): e is MediaStashEntry => {\n  if (!e || typeof e !== 'object') return false\n  const r = e as Record<string, unknown>\n  return typeof r.value === 'string' && typeof r.trustTier === 'string'\n}\n\nconst resolveFallbackStash = (\n  media: Media,\n  keys: ReadonlyArray<string>\n): { text: string; entryTier: MediaStashEntry['trustTier'] } | undefined => {\n  for (const key of keys) {\n    const entry = media.stash.get(key)\n    if (isMediaTextStashEntry(entry)) {\n      return { text: entry.value as string, entryTier: entry.trustTier }\n    }\n  }\n  return undefined\n}\n\nconst renderTextInEnvelope = (\n  text: string,\n  args: {\n    trustTier: MediaStashEntry['trustTier']\n    modality: 'inert' | 'extractable' | 'opaque'\n    nonce: string\n    toolName: string | undefined\n    renderTrustedContent: ChatHelpersCommon['renderTrustedContent']\n    renderUntrustedContent: ChatHelpersCommon['renderUntrustedContent']\n  }\n): string => {\n  if (args.trustTier === 'first-party') {\n    return args.renderTrustedContent(text, {\n      nonce: args.nonce,\n      kind: 'media-fallback',\n      tool: args.toolName,\n      modality: args.modality,\n    })\n  }\n  return args.renderUntrustedContent(text, {\n    nonce: args.nonce,\n    kind: 'media-fallback',\n    tool: args.toolName,\n    modality: args.modality,\n  })\n}\n\nconst renderSyntheticMediaDescription = (media: Media, byteLen: number | undefined): string =>\n  `[media: ${media.filename}, ${media.mimeType}, ${formatBytesHumanReadable(byteLen)}]`\n\n/**\n * The inline media id-marker: a harness-authored text block rendered immediately BEFORE each\n * media content block, so the model can reference the media by id in subsequent tool calls\n * (`media_id` args, `@id` pipe refs).\n *\n * Trust posture: the marker is structural reference data authored by the harness from the\n * harness-controlled `Media.id` (a UUID, not derivable from the payload) — it is NOT payload\n * content, carries no authority, and deliberately renders OUTSIDE the untrusted envelope with\n * fixed, non-instruction phrasing. This is a documented cross-battery convention: every LLM\n * battery that renders media emits the same marker shape.\n */\nconst renderMediaIdMarker = (media: Media): string => `[media id: ${media.id} | ${media.filename}]`\n\nconst renderMediaToContentBlocks = async (input: {\n  media: Media\n  toolName: string | undefined\n  nonce: string\n  unsupportedMediaPolicy: UnsupportedMediaPolicy\n  renderTrustedContent: ChatHelpersCommon['renderTrustedContent']\n  renderUntrustedContent: ChatHelpersCommon['renderUntrustedContent']\n  warn?: (msg: string) => void\n}): Promise<ChatCompletionsContentBlock[]> => {\n  const blocks = await renderMediaBodyBlocks(input)\n  return [{ type: 'text', text: renderMediaIdMarker(input.media) }, ...blocks]\n}\n\nconst renderMediaBodyBlocks = async (input: {\n  media: Media\n  toolName: string | undefined\n  nonce: string\n  unsupportedMediaPolicy: UnsupportedMediaPolicy\n  renderTrustedContent: ChatHelpersCommon['renderTrustedContent']\n  renderUntrustedContent: ChatHelpersCommon['renderUntrustedContent']\n  warn?: (msg: string) => void\n}): Promise<ChatCompletionsContentBlock[]> => {\n  const { media, toolName, nonce, unsupportedMediaPolicy, warn } = input\n  const modality = modalityHazardToAttr(media.modalityHazard)\n  const kind = media.kind\n\n  const fallbackPath = async (\n    keys: ReadonlyArray<string>,\n    allowSyntheticFallthrough: boolean\n  ): Promise<ChatCompletionsContentBlock[]> => {\n    const fallback = resolveFallbackStash(media, keys)\n    if (fallback) {\n      const text = renderTextInEnvelope(fallback.text, {\n        trustTier: fallback.entryTier,\n        modality,\n        nonce,\n        toolName,\n        renderTrustedContent: input.renderTrustedContent,\n        renderUntrustedContent: input.renderUntrustedContent,\n      })\n      return [{ type: 'text', text }]\n    }\n    if (!allowSyntheticFallthrough) {\n      // 'fallback-stash' falls through to 'synthetic-description' when no entry is found.\n      warn?.(\n        `unsupportedMediaPolicy='fallback-stash' for ${media.filename}: no matching stash entry — falling through to synthetic description.`\n      )\n    }\n    const byteLen = await media.byteLength()\n    const text = renderTextInEnvelope(renderSyntheticMediaDescription(media, byteLen), {\n      trustTier: media.trustTier,\n      modality,\n      nonce,\n      toolName,\n      renderTrustedContent: input.renderTrustedContent,\n      renderUntrustedContent: input.renderUntrustedContent,\n    })\n    return [{ type: 'text', text }]\n  }\n\n  if (kind === 'image') {\n    const b64 = await media.asBase64()\n    return [\n      {\n        type: 'image_url',\n        image_url: { url: `data:${media.mimeType};base64,${b64}` },\n      },\n    ]\n  }\n\n  if (kind === 'audio') {\n    const fmt = audioFormatFromMime(media.mimeType)\n    if (fmt === undefined) {\n      // Audio mime not natively expressible — same policy path as video.\n      if (unsupportedMediaPolicy === 'throw') {\n        throw new E_UNSUPPORTED_MEDIA_MODALITY([media.kind, media.mimeType, media.filename])\n      }\n      if (\n        unsupportedMediaPolicy === 'fallback-stash' ||\n        (typeof unsupportedMediaPolicy === 'object' &&\n          unsupportedMediaPolicy.mode === 'fallback-stash')\n      ) {\n        const keys =\n          typeof unsupportedMediaPolicy === 'object'\n            ? unsupportedMediaPolicy.stashKeys\n            : DEFAULT_STASH_FALLBACK_KEYS\n        return fallbackPath(keys, false)\n      }\n      return fallbackPath([], true)\n    }\n    const data = await media.asBase64()\n    return [\n      {\n        type: 'input_audio',\n        input_audio: { data, format: fmt },\n      },\n    ]\n  }\n\n  if (kind === 'document') {\n    const b64 = await media.asBase64()\n    return [\n      {\n        type: 'file',\n        file: {\n          filename: media.filename,\n          file_data: `data:${media.mimeType};base64,${b64}`,\n        },\n      },\n    ]\n  }\n\n  // kind === 'video' — not natively supported by Chat Completions wire format.\n  if (unsupportedMediaPolicy === 'throw') {\n    throw new E_UNSUPPORTED_MEDIA_MODALITY([media.kind, media.mimeType, media.filename])\n  }\n  if (\n    unsupportedMediaPolicy === 'fallback-stash' ||\n    (typeof unsupportedMediaPolicy === 'object' && unsupportedMediaPolicy.mode === 'fallback-stash')\n  ) {\n    const keys =\n      typeof unsupportedMediaPolicy === 'object'\n        ? unsupportedMediaPolicy.stashKeys\n        : DEFAULT_STASH_FALLBACK_KEYS\n    return fallbackPath(keys, false)\n  }\n  return fallbackPath([], true)\n}\n\n// ─── renderTimelineMessage ────────────────────────────────────────────────────\n\n/**\n * Renders a single timeline {@link @nhtio/adk!Message} into an OpenAI Chat Completions message —\n * mapping media to content blocks (`image_url` / `input_audio` / `file`), wrapping textual bodies\n * in the appropriate trust envelope, and applying the unsupported-media policy.\n */\nexport const renderTimelineMessage = async (input: {\n  message: Message\n  selfIdentity: string\n  unsupportedMediaPolicy: UnsupportedMediaPolicy\n  warn?: (msg: string) => void\n}): Promise<ChatCompletionsMessage> => {\n  const { message, selfIdentity, unsupportedMediaPolicy, warn } = input\n  const identifier =\n    message.identity?.identifier !== undefined && message.identity?.identifier !== null\n      ? String(message.identity.identifier)\n      : ''\n  const representationRaw =\n    message.identity?.representation !== undefined && message.identity?.representation !== null\n      ? message.identity.representation.toString()\n      : ''\n  // Prompt-facing identity (the `from=` attribute) reads `representation`;\n  // structural `messages[].name` reads `identifier`. Fall back to `identifier`\n  // when `representation` is empty so a bare-string identity still renders.\n  const representation = representationRaw.length > 0 ? representationRaw : identifier\n  const text = message.content !== undefined ? message.content.toString() : ''\n  const createdAtStr = message.createdAt.toISO?.() ?? ''\n  const createdAtAttr = createdAtStr ? ` createdAt=\"${escapeXmlAttribute(createdAtStr)}\"` : ''\n  const attachments = message.attachments\n  const hasAttachments = attachments.length > 0\n\n  // Build the text envelope first (same logic as before).\n  let envelopeText: string\n  let nameField: string | undefined\n  let role: 'user' | 'assistant'\n  if (message.role === 'user') {\n    role = 'user'\n    if (identifier.length === 0) {\n      envelopeText = text\n    } else {\n      nameField = sanitiseNameField(identifier)\n      const fromAttr = escapeXmlAttribute(representation)\n      envelopeText = `<message_${message.id} from=\"${fromAttr}\" role=\"user\"${createdAtAttr}>\\n${text}\\n</message_${message.id}>`\n    }\n  } else {\n    role = 'assistant'\n    if (identifier.length === 0 || identifier === selfIdentity) {\n      if (identifier.length > 0) {\n        nameField = sanitiseNameField(identifier)\n      }\n      envelopeText = text\n    } else {\n      nameField = sanitiseNameField(identifier)\n      const fromAttr = escapeXmlAttribute(representation)\n      envelopeText = `<peer_agent_output_${message.id} from=\"${fromAttr}\"${createdAtAttr}>\\n${text}\\n</peer_agent_output_${message.id}>`\n    }\n  }\n\n  if (!hasAttachments) {\n    const out: ChatCompletionsMessage = { role, content: envelopeText }\n    if (nameField !== undefined) out.name = nameField\n    return out\n  }\n\n  // Content-array path: text first (when present), then attachment blocks in array order.\n  const blocks: ChatCompletionsContentBlock[] = []\n  if (text.length > 0) {\n    blocks.push({ type: 'text', text: envelopeText })\n  }\n  for (const media of attachments) {\n    const mediaBlocks = await renderMediaToContentBlocks({\n      media,\n      toolName: undefined,\n      nonce: message.id,\n      unsupportedMediaPolicy,\n      renderTrustedContent,\n      renderUntrustedContent,\n      warn,\n    })\n    for (const b of mediaBlocks) blocks.push(b)\n  }\n  const out: ChatCompletionsMessage = { role, content: blocks }\n  if (nameField !== undefined) out.name = nameField\n  return out\n}\n/** Default timeline-message renderer; alias of {@link renderTimelineMessage}. */\nexport const defaultRenderTimelineMessage = renderTimelineMessage\n\n// ─── renderChatCompletionsToolCallResult ──────────────────────────────────────\n\nconst isSpooledArtifactResult = (\n  results: SpooledArtifact | Tokenizable\n): results is SpooledArtifact =>\n  isInstanceOf(results, 'SpooledArtifact') ||\n  // Subclasses identify via the base class guard upstream\n  ((results as unknown as { constructor?: { isSpooledArtifactConstructor?: boolean } })\n    ?.constructor !== null &&\n    (results as unknown as { constructor?: { isSpooledArtifactConstructor?: boolean } })\n      ?.constructor !== undefined &&\n    typeof (\n      results as unknown as {\n        constructor: { isSpooledArtifactConstructor?: (c: unknown) => boolean }\n      }\n    ).constructor.isSpooledArtifactConstructor === 'function')\n\nconst looksLikeSpooledArtifact = (value: unknown): value is SpooledArtifact => {\n  if (!value || typeof value !== 'object') return false\n  const v = value as Record<string, unknown>\n  return (\n    typeof v.asString === 'function' &&\n    typeof v.byteLength === 'function' &&\n    typeof v.lineCount === 'function' &&\n    typeof v.estimateTokens === 'function'\n  )\n}\n\nconst renderArtifactHandleBody = (\n  toolCall: ToolCall,\n  artifact: SpooledArtifact,\n  byteLength: number,\n  lineCount: number,\n  estimatedTokens: number | undefined,\n  encoding: string | undefined\n): string => {\n  const ctor = (\n    artifact as unknown as {\n      constructor: { toolMethods?: ReadonlyArray<{ name: string; description?: string }> }\n    }\n  ).constructor\n  const methods = ctor?.toolMethods ?? []\n  const lines: string[] = []\n  lines.push(`This tool returned a large artifact that was not inlined to preserve context budget.`)\n  lines.push(``)\n  lines.push(`Artifact metadata:`)\n  lines.push(`- callId: ${toolCall.id}`)\n  lines.push(`- kind: ${ctor?.constructor?.name ?? 'SpooledArtifact'}`)\n  lines.push(`- byteLength: ${byteLength}`)\n  lines.push(`- lineCount: ${lineCount}`)\n  if (estimatedTokens !== undefined && encoding) {\n    lines.push(`- estimatedTokens: ${estimatedTokens} (encoding: ${encoding})`)\n  }\n  lines.push(``)\n  lines.push(`To read this artifact in this turn, call one of the following tools with`)\n  lines.push(`callId=${toolCall.id}:`)\n  for (const m of methods) {\n    if (m.description) {\n      lines.push(`- ${m.name} — ${m.description}`)\n    } else {\n      lines.push(`- ${m.name}`)\n    }\n  }\n  lines.push(``)\n  lines.push(\n    `The artifact persists in this turn's context — multiple queries against the same callId are allowed and efficient. Do not assume the body has been inlined anywhere else.`\n  )\n  return lines.join('\\n')\n}\n\n/**\n * Renders a tool call's result(s) into the OpenAI Chat Completions tool-message body — either a\n * plain string or an array of content blocks when the result carries media — wrapping textual\n * output in the trust envelope appropriate to the tool's trust level.\n */\nexport const renderChatCompletionsToolCallResult = async (input: {\n  toolCall: ToolCall\n  results: Tokenizable | SpooledArtifact | SpooledArtifact[] | Media | Media[]\n  tool: Tool | ArtifactTool | undefined\n  renderUntrustedContent: ChatHelpersCommon['renderUntrustedContent']\n  renderTrustedContent: ChatHelpersCommon['renderTrustedContent']\n  unsupportedMediaPolicy: UnsupportedMediaPolicy\n  warn?: (msg: string) => void\n}): Promise<string | ChatCompletionsContentBlock[]> => {\n  const { toolCall, results, tool, warn, unsupportedMediaPolicy } = input\n  const isTrusted =\n    tool !== null && tool !== undefined && (tool as { trusted?: boolean }).trusted === true\n\n  if (tool === undefined) {\n    warn?.(\n      `Tool \"${toolCall.tool}\" is not present in the bound tool registry at render time; defaulting to untrusted envelope.`\n    )\n  }\n\n  // Media / Media[] silo — bypasses Tool.trusted (Trust-Is-Content rule). Envelope is sourced\n  // from each Media's own trustTier; modality from each Media's modalityHazard.\n  const isMediaResult = Media.isMedia(results)\n  const isMediaArrayResult =\n    Array.isArray(results) && results.length > 0 && results.every((r) => Media.isMedia(r))\n  if (isMediaResult || isMediaArrayResult) {\n    const mediaList = isMediaResult ? [results as Media] : (results as Media[])\n    const blocks: ChatCompletionsContentBlock[] = []\n    for (const media of mediaList) {\n      const mediaBlocks = await renderMediaToContentBlocks({\n        media,\n        toolName: toolCall.tool,\n        nonce: toolCall.checksum,\n        unsupportedMediaPolicy,\n        renderTrustedContent: input.renderTrustedContent,\n        renderUntrustedContent: input.renderUntrustedContent,\n        warn,\n      })\n      for (const b of mediaBlocks) blocks.push(b)\n    }\n    return blocks\n  }\n\n  // SpooledArtifact[] silo — render each artifact through the existing single-artifact path\n  // and concatenate the bodies. Trust envelope is decided per-artifact via the surrounding\n  // Tool.trusted flag (same as single SpooledArtifact today).\n  if (Array.isArray(results)) {\n    const parts: string[] = []\n    for (const a of results) {\n      const body = await (a as SpooledArtifact).asString()\n      parts.push(body)\n    }\n    const joined = parts.join('\\n\\n')\n    if (isTrusted) {\n      return input.renderTrustedContent(joined, {\n        nonce: toolCall.checksum,\n        kind: 'trusted-tool-result',\n        tool: toolCall.tool,\n      })\n    }\n    return input.renderUntrustedContent(joined, {\n      nonce: toolCall.checksum,\n      kind: 'tool-result',\n      tool: toolCall.tool,\n    })\n  }\n\n  const isSpooled = looksLikeSpooledArtifact(results)\n\n  // Handle-pattern branch: spooled + inline=false → always untrusted (queryable-data, not policy).\n  if (isSpooled && toolCall.inline === false) {\n    const artifact = results as SpooledArtifact\n    let byteLength = 0\n    let lineCount = 0\n    try {\n      byteLength = await artifact.byteLength()\n    } catch {\n      byteLength = 0\n    }\n    try {\n      lineCount = await artifact.lineCount()\n    } catch {\n      lineCount = 0\n    }\n    const body = renderArtifactHandleBody(\n      toolCall,\n      artifact,\n      byteLength,\n      lineCount,\n      undefined,\n      undefined\n    )\n    return input.renderUntrustedContent(body, {\n      nonce: toolCall.checksum,\n      kind: 'artifact-handle',\n      tool: toolCall.tool,\n    })\n  }\n\n  // Inline path: render full body via the appropriate envelope.\n  if (!isSpooled && toolCall.inline === false) {\n    warn?.(\n      `Tool call ${toolCall.id} has inline=false but results is a Tokenizable (not a SpooledArtifact); rendering inline anyway.`\n    )\n  }\n\n  let body: string\n  if (isSpooled) {\n    body = await (results as SpooledArtifact).asString()\n  } else {\n    body = (results as Tokenizable).toString()\n  }\n\n  if (isTrusted) {\n    return input.renderTrustedContent(body, {\n      nonce: toolCall.checksum,\n      kind: 'trusted-tool-result',\n      tool: toolCall.tool,\n    })\n  }\n  return input.renderUntrustedContent(body, {\n    nonce: toolCall.checksum,\n    kind: 'tool-result',\n    tool: toolCall.tool,\n  })\n}\n/** Default tool-call-result renderer; alias of {@link renderChatCompletionsToolCallResult}. */\nexport const defaultRenderChatCompletionsToolCallResult = renderChatCompletionsToolCallResult\n\n// suppress unused; kept for forward-compat with stricter spool guards\nvoid isSpooledArtifactResult\n\n// ─── buildChatCompletionsHistory ──────────────────────────────────────────────\n\ntype TimelineItem =\n  | { kind: 'message'; createdAt: number; value: Message }\n  | { kind: 'thought'; createdAt: number; value: Thought }\n  | { kind: 'toolCall'; createdAt: number; value: ToolCall }\n\n/**\n * Assembles the complete OpenAI Chat Completions message history for a dispatch — system prompt and\n * content buckets, the interleaved timeline of messages/thoughts/tool calls (with synthetic\n * `assistant.tool_calls` and `tool.tool_call_id` shaping), and the collected opaque reasoning\n * payloads — by delegating to the injected sub-renderers.\n */\nexport const buildChatCompletionsHistory = async (input: {\n  systemPrompt: Tokenizable\n  standingInstructions: Iterable<Tokenizable>\n  memories: Iterable<Memory>\n  retrievables: Iterable<Retrievable>\n  messages: Iterable<Message>\n  thoughts: Iterable<Thought>\n  toolCalls: Iterable<ToolCall>\n  tools: ToolRegistry\n  renderedToolCallResults: Map<string, string | ChatCompletionsContentBlock[]>\n  bucketOrder: ChatCompletionsBucketOrder\n  selfIdentity: string\n  thoughtSurfacing: 'all-self' | 'latest-self' | 'all'\n  replayCompatibility: ReadonlyArray<string>\n  unsupportedMediaPolicy: UnsupportedMediaPolicy\n  renderChatCompletionsToolCallResult: ChatCompletionsHelpers['renderChatCompletionsToolCallResult']\n  renderChatCompletionsSystemPrompt: ChatHelpersCommon['renderChatCompletionsSystemPrompt']\n  renderStandingInstructions: ChatHelpersCommon['renderStandingInstructions']\n  renderMemories: ChatHelpersCommon['renderMemories']\n  renderRetrievables: ChatHelpersCommon['renderRetrievables']\n  renderRetrievableSafetyDirective: ChatHelpersCommon['renderRetrievableSafetyDirective']\n  renderFirstPartyRetrievables: ChatHelpersCommon['renderFirstPartyRetrievables']\n  renderThirdPartyPublicRetrievables: ChatHelpersCommon['renderThirdPartyPublicRetrievables']\n  renderThirdPartyPrivateRetrievables: ChatHelpersCommon['renderThirdPartyPrivateRetrievables']\n  renderTimelineMessage: ChatCompletionsHelpers['renderTimelineMessage']\n  renderThought: ChatHelpersCommon['renderThought']\n  filterThoughts: ChatHelpersCommon['filterThoughts']\n  renderUntrustedContent: ChatHelpersCommon['renderUntrustedContent']\n  renderTrustedContent: ChatHelpersCommon['renderTrustedContent']\n  warn?: (msg: string) => void\n}): Promise<{\n  messages: ChatCompletionsMessage[]\n  reasoningPayloads: Array<{ id: string; replayCompatibility: string; payload: unknown }>\n}> => {\n  const out: ChatCompletionsMessage[] = []\n  const reasoningPayloads: Array<{\n    id: string\n    replayCompatibility: string\n    payload: unknown\n  }> = []\n\n  const buckets = input.bucketOrder\n  const timelineIdx = buckets.indexOf('timeline')\n\n  // Build leading system content from base prompt + before-timeline buckets.\n  const leadingSystem = await input.renderChatCompletionsSystemPrompt({\n    systemPrompt: input.systemPrompt,\n    standingInstructions: input.standingInstructions,\n    memories: input.memories,\n    retrievables: input.retrievables,\n    bucketOrder: buckets,\n    renderStandingInstructions: input.renderStandingInstructions,\n    renderMemories: input.renderMemories,\n    renderRetrievables: input.renderRetrievables,\n    renderRetrievableSafetyDirective: input.renderRetrievableSafetyDirective,\n    renderFirstPartyRetrievables: input.renderFirstPartyRetrievables,\n    renderThirdPartyPublicRetrievables: input.renderThirdPartyPublicRetrievables,\n    renderThirdPartyPrivateRetrievables: input.renderThirdPartyPrivateRetrievables,\n    renderUntrustedContent: input.renderUntrustedContent,\n  })\n  if (leadingSystem.length > 0) {\n    out.push({ role: 'system', content: leadingSystem })\n  }\n\n  // Build the timeline (if present in bucketOrder).\n  const includesTimeline = timelineIdx !== -1\n  if (includesTimeline) {\n    // Filter thoughts per surfacing mode + compatibility.\n    const survivingThoughts = input.filterThoughts(\n      input.thoughts,\n      input.thoughtSurfacing,\n      input.selfIdentity,\n      input.replayCompatibility\n    )\n\n    // Build sorted timeline items.\n    const items: TimelineItem[] = []\n    for (const m of input.messages) {\n      items.push({ kind: 'message', createdAt: m.createdAt.toMillis(), value: m })\n    }\n    for (const t of survivingThoughts) {\n      items.push({ kind: 'thought', createdAt: t.createdAt.toMillis(), value: t })\n    }\n    for (const tc of input.toolCalls) {\n      items.push({ kind: 'toolCall', createdAt: tc.createdAt.toMillis(), value: tc })\n    }\n    items.sort((a, b) => a.createdAt - b.createdAt)\n\n    const replaySet = new Set<string>([...input.replayCompatibility])\n\n    for (const item of items) {\n      if (item.kind === 'message') {\n        out.push(\n          await input.renderTimelineMessage({\n            message: item.value,\n            selfIdentity: input.selfIdentity,\n            unsupportedMediaPolicy: input.unsupportedMediaPolicy,\n            warn: input.warn,\n          })\n        )\n      } else if (item.kind === 'thought') {\n        const t = item.value\n        const identifier = String(t.identity?.identifier ?? '')\n        const isSelf = identifier === input.selfIdentity\n        const hasPayload = t.payload !== undefined\n        const compatTag = t.replayCompatibility\n\n        if (hasPayload && compatTag && replaySet.has(compatTag)) {\n          // Opaque reasoning — side-channel + summary envelope.\n          reasoningPayloads.push({\n            id: t.id,\n            replayCompatibility: compatTag,\n            payload: t.payload,\n          })\n          const envelope = input.renderThought(\n            t.content.toString(),\n            {\n              nonce: t.id,\n              kind: 'opaque-reasoning',\n              from: identifier,\n              createdAt: t.createdAt?.toISO?.() ?? undefined,\n              replayCompatibility: compatTag,\n            },\n            t.payload\n          )\n          const synthetic: ChatCompletionsMessage = {\n            role: 'assistant',\n            content: envelope,\n          }\n          if (!isSelf && identifier.length > 0) {\n            synthetic.name = sanitiseNameField(identifier)\n          }\n          out.push(synthetic)\n        } else if (!hasPayload) {\n          // Plain-text reasoning (no payload, or tagged plain-text, or tagged but matched).\n          const envelope = input.renderThought(t.content.toString(), {\n            nonce: t.id,\n            kind: isSelf ? 'self-reasoning' : 'peer-reasoning',\n            from: identifier,\n            createdAt: t.createdAt?.toISO?.() ?? undefined,\n          })\n          const synthetic: ChatCompletionsMessage = {\n            role: 'assistant',\n            content: envelope,\n          }\n          if (!isSelf && identifier.length > 0) {\n            synthetic.name = sanitiseNameField(identifier)\n          }\n          out.push(synthetic)\n        }\n        // else: opaque, non-matching → elided (NOT removed from ctx.turnThoughts upstream).\n      } else {\n        // tool call: emit a synthetic assistant message carrying tool_calls[],\n        // followed by a tool-role message with the result.\n        const tc = item.value\n        const assistantMsg: ChatCompletionsMessage = {\n          role: 'assistant',\n          content: null,\n          tool_calls: [\n            {\n              id: tc.id,\n              type: 'function',\n              function: {\n                name: tc.tool,\n                arguments: typeof tc.args === 'string' ? tc.args : JSON.stringify(tc.args ?? {}),\n              },\n            },\n          ],\n        }\n        out.push(assistantMsg)\n\n        let rendered = input.renderedToolCallResults.get(tc.id)\n        if (rendered === undefined) {\n          const tool = input.tools.get?.(tc.tool)\n          rendered = await input.renderChatCompletionsToolCallResult({\n            toolCall: tc,\n            results: tc.results as\n              | Tokenizable\n              | SpooledArtifact\n              | SpooledArtifact[]\n              | Media\n              | Media[],\n            tool: tool as Tool | ArtifactTool | undefined,\n            renderUntrustedContent: input.renderUntrustedContent,\n            renderTrustedContent: input.renderTrustedContent,\n            unsupportedMediaPolicy: input.unsupportedMediaPolicy,\n            warn: input.warn,\n          })\n        }\n        out.push({\n          role: 'tool',\n          content: rendered,\n          tool_call_id: tc.id,\n        })\n      }\n    }\n  }\n\n  // Trailing system message for after-timeline buckets.\n  if (includesTimeline) {\n    const trailingParts: string[] = []\n    for (let i = timelineIdx + 1; i < buckets.length; i++) {\n      const label = buckets[i]!\n      if (label === 'standingInstructions') {\n        const block = input.renderStandingInstructions(input.standingInstructions)\n        if (block.length > 0) trailingParts.push(block)\n      } else if (label === 'memories') {\n        const wrapped: Array<{ memory: Memory; attrs: MemoryAttrs }> = []\n        for (const m of input.memories) {\n          wrapped.push(memoryToAttrs(m))\n        }\n        const block = input.renderMemories(wrapped)\n        if (block.length > 0) trailingParts.push(block)\n      } else if (label === 'retrievables') {\n        const wrapped: Array<{ retrievable: Retrievable; attrs: RetrievableAttrs }> = []\n        for (const r of input.retrievables) {\n          wrapped.push(retrievableToAttrs(r))\n        }\n        const block = await input.renderRetrievables(wrapped, {\n          renderRetrievableSafetyDirective: input.renderRetrievableSafetyDirective,\n          renderFirstPartyRetrievables: input.renderFirstPartyRetrievables,\n          renderThirdPartyPublicRetrievables: input.renderThirdPartyPublicRetrievables,\n          renderThirdPartyPrivateRetrievables: input.renderThirdPartyPrivateRetrievables,\n          renderUntrustedContent: input.renderUntrustedContent,\n        })\n        if (block.length > 0) trailingParts.push(block)\n      }\n    }\n    if (trailingParts.length > 0) {\n      out.push({ role: 'system', content: trailingParts.join('\\n\\n') })\n    }\n  }\n\n  return { messages: out, reasoningPayloads }\n}\n/** Default history assembler; alias of {@link buildChatCompletionsHistory}. */\nexport const defaultBuildChatCompletionsHistory = buildChatCompletionsHistory\n\n// ─── createChatCompletionsToolCallDeltaAccumulator ────────────────────────────\n\n/**\n * Creates a fresh accumulator that stitches streamed {@link ChatCompletionsToolCallDelta} fragments\n * (keyed by their stream index) into fully-assembled tool calls, drained once the stream completes.\n */\nexport const createChatCompletionsToolCallDeltaAccumulator =\n  (): ChatCompletionsToolCallDeltaAccumulator => {\n    const byIndex = new Map<\n      number,\n      { id?: string; type?: 'function'; name: string; args: string }\n    >()\n    return {\n      feed(delta: ChatCompletionsToolCallDelta): void {\n        const idx = delta.index\n        let entry = byIndex.get(idx)\n        if (!entry) {\n          entry = { name: '', args: '' }\n          byIndex.set(idx, entry)\n        }\n        if (delta.id !== undefined) entry.id = delta.id\n        if (delta.type !== undefined) entry.type = delta.type\n        if (delta.function?.name !== undefined) {\n          entry.name = entry.name + delta.function.name\n        }\n        if (delta.function?.arguments !== undefined) {\n          entry.args = entry.args + delta.function.arguments\n        }\n      },\n      drain(): AssembledToolCall[] {\n        const out: AssembledToolCall[] = []\n        const indices = Array.from(byIndex.keys()).sort((a, b) => a - b)\n        for (const idx of indices) {\n          const e = byIndex.get(idx)!\n          out.push({\n            id: e.id ?? `call_${idx}`,\n            type: e.type ?? 'function',\n            name: e.name,\n            args: e.args,\n          })\n        }\n        return out\n      },\n    }\n  }\n/** Default delta-accumulator factory; alias of {@link createChatCompletionsToolCallDeltaAccumulator}. */\nexport const defaultCreateChatCompletionsToolCallDeltaAccumulator =\n  createChatCompletionsToolCallDeltaAccumulator\n"],"mappings":"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"}

package/batteries/llm/openai_chat_completions/helpers.mjs

@@ -107,7 +107,26 @@ var renderTextInEnvelope = (text, args) => {
 	});
 };
 var renderSyntheticMediaDescription = (media, byteLen) => `[media: ${media.filename}, ${media.mimeType}, ${formatBytesHumanReadable(byteLen)}]`;
+/**
+* The inline media id-marker: a harness-authored text block rendered immediately BEFORE each
+* media content block, so the model can reference the media by id in subsequent tool calls
+* (`media_id` args, `@id` pipe refs).
+*
+* Trust posture: the marker is structural reference data authored by the harness from the
+* harness-controlled `Media.id` (a UUID, not derivable from the payload) — it is NOT payload
+* content, carries no authority, and deliberately renders OUTSIDE the untrusted envelope with
+* fixed, non-instruction phrasing. This is a documented cross-battery convention: every LLM
+* battery that renders media emits the same marker shape.
+*/
+var renderMediaIdMarker = (media) => `[media id: ${media.id} | ${media.filename}]`;
 var renderMediaToContentBlocks = async (input) => {
+	const blocks = await renderMediaBodyBlocks(input);
+	return [{
+		type: "text",
+		text: renderMediaIdMarker(input.media)
+	}, ...blocks];
+};
+var renderMediaBodyBlocks = async (input) => {
 	const { media, toolName, nonce, unsupportedMediaPolicy, warn } = input;
 	const modality = modalityHazardToAttr(media.modalityHazard);
 	const kind = media.kind;

package/batteries/llm/openai_chat_completions/helpers.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.mjs","names":[],"sources":["../../../../src/batteries/llm/openai_chat_completions/helpers.ts"],"sourcesContent":["/**\n * Swappable translation helpers for rendering ADK state into Chat Completions requests.\n *\n * @module @nhtio/adk/batteries/llm/openai_chat_completions/helpers\n *\n * @remarks\n * The swappable translation helpers that turn ADK primitives into OpenAI Chat Completions wire\n * shapes. Each helper is exported under its unprefixed name AND under a `default*` alias so\n * consumers can compose partial overrides. Helpers that compose other helpers receive their\n * dependents via explicit input arguments — never via module-level closure — so a swap at any\n * layer propagates correctly.\n *\n * The wire-shape-AGNOSTIC helpers (`renderUntrustedContent`, `renderMemories`,\n * `renderChatCompletionsSystemPrompt`, `toolsToChatCompletionsTools`, …) now live in the shared,\n * internal `../chat_common/helpers` submodule and are re-exported here under their original names\n * so every existing import keeps resolving. Only the OpenAI-WIRE-SPECIFIC helpers\n * (`renderTimelineMessage`, `renderChatCompletionsToolCallResult`, `buildChatCompletionsHistory`,\n * `createChatCompletionsToolCallDeltaAccumulator`) and the reasoning-field extractor are defined\n * here.\n */\n\nimport { Media } from '@nhtio/adk/common'\nimport { isInstanceOf } from '@nhtio/adk/guards'\nimport { E_UNSUPPORTED_MEDIA_MODALITY } from './exceptions'\nimport {\n  escapeXmlAttribute,\n  sanitiseNameField,\n  memoryToAttrs,\n  retrievableToAttrs,\n  renderTrustedContent,\n  renderUntrustedContent,\n} from '../chat_common/helpers'\nimport type { ChatHelpersCommon } from '../chat_common/types'\nimport type {\n  Tool,\n  ArtifactTool,\n  ToolRegistry,\n  Tokenizable,\n  Memory,\n  Message,\n  Thought,\n  ToolCall,\n  Retrievable,\n  SpooledArtifact,\n  MediaModalityHazard,\n  MediaStashEntry,\n} from '@nhtio/adk/common'\nimport type {\n  ChatCompletionsMessage,\n  ChatCompletionsContentBlock,\n  ChatCompletionsToolCallDelta,\n  ChatCompletionsToolCallDeltaAccumulator,\n  AssembledToolCall,\n  ChatCompletionsBucketOrder,\n  MemoryAttrs,\n  RetrievableAttrs,\n  ChatCompletionsHelpers,\n  UnsupportedMediaPolicy,\n  ReasoningField,\n  ReasoningFieldPrecedence,\n  ReasoningExtract,\n} from './types'\n\n// ─── Re-exported wire-shape-agnostic helpers (shared submodule) ───────────────\n// These are defined once in `../chat_common/helpers` and shared with the native Ollama battery.\n// Re-exported here (bare + `default*`) so every existing\n// `@nhtio/adk/batteries/llm/openai_chat_completions` import keeps resolving unchanged.\nexport {\n  descriptionToChatCompletionsJsonSchema,\n  defaultDescriptionToChatCompletionsJsonSchema,\n  renderUntrustedContent,\n  defaultRenderUntrustedContent,\n  renderTrustedContent,\n  defaultRenderTrustedContent,\n  renderStandingInstructions,\n  defaultRenderStandingInstructions,\n  renderMemories,\n  defaultRenderMemories,\n  renderRetrievableSafetyDirective,\n  defaultRenderRetrievableSafetyDirective,\n  renderFirstPartyRetrievables,\n  defaultRenderFirstPartyRetrievables,\n  renderThirdPartyPublicRetrievables,\n  defaultRenderThirdPartyPublicRetrievables,\n  renderThirdPartyPrivateRetrievables,\n  defaultRenderThirdPartyPrivateRetrievables,\n  renderRetrievables,\n  defaultRenderRetrievables,\n  renderThought,\n  defaultRenderThought,\n  filterThoughts,\n  defaultFilterThoughts,\n  toolsToChatCompletionsTools,\n  defaultToolsToChatCompletionsTools,\n  renderChatCompletionsSystemPrompt,\n  defaultRenderChatCompletionsSystemPrompt,\n} from '../chat_common/helpers'\n\n// ─── extractReasoningFields ───────────────────────────────────────────────────\n\n/**\n * Pulls model reasoning/thinking text out of a Chat Completions response message or stream delta,\n * reading every wire field named in `precedence` that carries a non-empty string.\n *\n * @remarks\n * Reasoning is not part of OpenAI's official Chat Completions spec, so OpenAI-compatible providers\n * disagree on the field name (`reasoning` for Ollama and current vLLM; `reasoning_content` for\n * legacy vLLM and DeepSeek). This reads the union, in `precedence` order, and de-duplicates by\n * content value: a field whose text exactly matches one already kept is dropped.\n *\n * The result length encodes the emission rule the callers follow:\n * - `0` — no reasoning present.\n * - `1` — a single thought (covers \"only one field present\" AND \"several present but identical\").\n * - `≥2` — divergent fields; each surfaces as its own thought rather than silently dropping one.\n *\n * @param src - The response `message` or stream `delta` to read from.\n * @param precedence - Ordered, de-duplicated field names to read (see `reasoningFieldPrecedence`).\n * @returns The present, content-deduplicated reasoning traces in precedence order.\n */\nexport const extractReasoningFields = (\n  src: Partial<Record<ReasoningField, string | null | undefined>> | undefined,\n  precedence: ReasoningFieldPrecedence\n): ReasoningExtract[] => {\n  const out: ReasoningExtract[] = []\n  for (const field of precedence) {\n    const value = src?.[field]\n    if (typeof value !== 'string' || value.length === 0) continue\n    if (out.some((e) => e.content === value)) continue\n    out.push({ field, content: value })\n  }\n  return out\n}\n\n// ─── Media rendering helpers (OpenAI content-block specific) ──────────────────\n\nconst DEFAULT_STASH_FALLBACK_KEYS: ReadonlyArray<string> = [\n  'text:transcript',\n  'text:caption',\n  'text:description',\n]\n\nconst modalityHazardToAttr = (h: MediaModalityHazard): 'inert' | 'extractable' | 'opaque' => {\n  if (h === 'inert') return 'inert'\n  if (h === 'extractable-instructions') return 'extractable'\n  return 'opaque'\n}\n\nconst formatBytesHumanReadable = (bytes: number | undefined): string => {\n  if (bytes === undefined || !Number.isFinite(bytes)) return 'unknown size'\n  if (bytes < 1024) return `${bytes} B`\n  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`\n  if (bytes < 1024 * 1024 * 1024) return `${(bytes / (1024 * 1024)).toFixed(1)} MB`\n  return `${(bytes / (1024 * 1024 * 1024)).toFixed(1)} GB`\n}\n\nconst audioFormatFromMime = (mime: string): 'wav' | 'mp3' | undefined => {\n  const m = mime.toLowerCase()\n  if (m.includes('wav') || m.includes('x-wav') || m.includes('wave')) return 'wav'\n  if (m.includes('mpeg') || m.includes('mp3')) return 'mp3'\n  return undefined\n}\n\nconst isMediaTextStashEntry = (e: unknown): e is MediaStashEntry => {\n  if (!e || typeof e !== 'object') return false\n  const r = e as Record<string, unknown>\n  return typeof r.value === 'string' && typeof r.trustTier === 'string'\n}\n\nconst resolveFallbackStash = (\n  media: Media,\n  keys: ReadonlyArray<string>\n): { text: string; entryTier: MediaStashEntry['trustTier'] } | undefined => {\n  for (const key of keys) {\n    const entry = media.stash.get(key)\n    if (isMediaTextStashEntry(entry)) {\n      return { text: entry.value as string, entryTier: entry.trustTier }\n    }\n  }\n  return undefined\n}\n\nconst renderTextInEnvelope = (\n  text: string,\n  args: {\n    trustTier: MediaStashEntry['trustTier']\n    modality: 'inert' | 'extractable' | 'opaque'\n    nonce: string\n    toolName: string | undefined\n    renderTrustedContent: ChatHelpersCommon['renderTrustedContent']\n    renderUntrustedContent: ChatHelpersCommon['renderUntrustedContent']\n  }\n): string => {\n  if (args.trustTier === 'first-party') {\n    return args.renderTrustedContent(text, {\n      nonce: args.nonce,\n      kind: 'media-fallback',\n      tool: args.toolName,\n      modality: args.modality,\n    })\n  }\n  return args.renderUntrustedContent(text, {\n    nonce: args.nonce,\n    kind: 'media-fallback',\n    tool: args.toolName,\n    modality: args.modality,\n  })\n}\n\nconst renderSyntheticMediaDescription = (media: Media, byteLen: number | undefined): string =>\n  `[media: ${media.filename}, ${media.mimeType}, ${formatBytesHumanReadable(byteLen)}]`\n\nconst renderMediaToContentBlocks = async (input: {\n  media: Media\n  toolName: string | undefined\n  nonce: string\n  unsupportedMediaPolicy: UnsupportedMediaPolicy\n  renderTrustedContent: ChatHelpersCommon['renderTrustedContent']\n  renderUntrustedContent: ChatHelpersCommon['renderUntrustedContent']\n  warn?: (msg: string) => void\n}): Promise<ChatCompletionsContentBlock[]> => {\n  const { media, toolName, nonce, unsupportedMediaPolicy, warn } = input\n  const modality = modalityHazardToAttr(media.modalityHazard)\n  const kind = media.kind\n\n  const fallbackPath = async (\n    keys: ReadonlyArray<string>,\n    allowSyntheticFallthrough: boolean\n  ): Promise<ChatCompletionsContentBlock[]> => {\n    const fallback = resolveFallbackStash(media, keys)\n    if (fallback) {\n      const text = renderTextInEnvelope(fallback.text, {\n        trustTier: fallback.entryTier,\n        modality,\n        nonce,\n        toolName,\n        renderTrustedContent: input.renderTrustedContent,\n        renderUntrustedContent: input.renderUntrustedContent,\n      })\n      return [{ type: 'text', text }]\n    }\n    if (!allowSyntheticFallthrough) {\n      // 'fallback-stash' falls through to 'synthetic-description' when no entry is found.\n      warn?.(\n        `unsupportedMediaPolicy='fallback-stash' for ${media.filename}: no matching stash entry — falling through to synthetic description.`\n      )\n    }\n    const byteLen = await media.byteLength()\n    const text = renderTextInEnvelope(renderSyntheticMediaDescription(media, byteLen), {\n      trustTier: media.trustTier,\n      modality,\n      nonce,\n      toolName,\n      renderTrustedContent: input.renderTrustedContent,\n      renderUntrustedContent: input.renderUntrustedContent,\n    })\n    return [{ type: 'text', text }]\n  }\n\n  if (kind === 'image') {\n    const b64 = await media.asBase64()\n    return [\n      {\n        type: 'image_url',\n        image_url: { url: `data:${media.mimeType};base64,${b64}` },\n      },\n    ]\n  }\n\n  if (kind === 'audio') {\n    const fmt = audioFormatFromMime(media.mimeType)\n    if (fmt === undefined) {\n      // Audio mime not natively expressible — same policy path as video.\n      if (unsupportedMediaPolicy === 'throw') {\n        throw new E_UNSUPPORTED_MEDIA_MODALITY([media.kind, media.mimeType, media.filename])\n      }\n      if (\n        unsupportedMediaPolicy === 'fallback-stash' ||\n        (typeof unsupportedMediaPolicy === 'object' &&\n          unsupportedMediaPolicy.mode === 'fallback-stash')\n      ) {\n        const keys =\n          typeof unsupportedMediaPolicy === 'object'\n            ? unsupportedMediaPolicy.stashKeys\n            : DEFAULT_STASH_FALLBACK_KEYS\n        return fallbackPath(keys, false)\n      }\n      return fallbackPath([], true)\n    }\n    const data = await media.asBase64()\n    return [\n      {\n        type: 'input_audio',\n        input_audio: { data, format: fmt },\n      },\n    ]\n  }\n\n  if (kind === 'document') {\n    const b64 = await media.asBase64()\n    return [\n      {\n        type: 'file',\n        file: {\n          filename: media.filename,\n          file_data: `data:${media.mimeType};base64,${b64}`,\n        },\n      },\n    ]\n  }\n\n  // kind === 'video' — not natively supported by Chat Completions wire format.\n  if (unsupportedMediaPolicy === 'throw') {\n    throw new E_UNSUPPORTED_MEDIA_MODALITY([media.kind, media.mimeType, media.filename])\n  }\n  if (\n    unsupportedMediaPolicy === 'fallback-stash' ||\n    (typeof unsupportedMediaPolicy === 'object' && unsupportedMediaPolicy.mode === 'fallback-stash')\n  ) {\n    const keys =\n      typeof unsupportedMediaPolicy === 'object'\n        ? unsupportedMediaPolicy.stashKeys\n        : DEFAULT_STASH_FALLBACK_KEYS\n    return fallbackPath(keys, false)\n  }\n  return fallbackPath([], true)\n}\n\n// ─── renderTimelineMessage ────────────────────────────────────────────────────\n\n/**\n * Renders a single timeline {@link @nhtio/adk!Message} into an OpenAI Chat Completions message —\n * mapping media to content blocks (`image_url` / `input_audio` / `file`), wrapping textual bodies\n * in the appropriate trust envelope, and applying the unsupported-media policy.\n */\nexport const renderTimelineMessage = async (input: {\n  message: Message\n  selfIdentity: string\n  unsupportedMediaPolicy: UnsupportedMediaPolicy\n  warn?: (msg: string) => void\n}): Promise<ChatCompletionsMessage> => {\n  const { message, selfIdentity, unsupportedMediaPolicy, warn } = input\n  const identifier =\n    message.identity?.identifier !== undefined && message.identity?.identifier !== null\n      ? String(message.identity.identifier)\n      : ''\n  const representationRaw =\n    message.identity?.representation !== undefined && message.identity?.representation !== null\n      ? message.identity.representation.toString()\n      : ''\n  // Prompt-facing identity (the `from=` attribute) reads `representation`;\n  // structural `messages[].name` reads `identifier`. Fall back to `identifier`\n  // when `representation` is empty so a bare-string identity still renders.\n  const representation = representationRaw.length > 0 ? representationRaw : identifier\n  const text = message.content !== undefined ? message.content.toString() : ''\n  const createdAtStr = message.createdAt.toISO?.() ?? ''\n  const createdAtAttr = createdAtStr ? ` createdAt=\"${escapeXmlAttribute(createdAtStr)}\"` : ''\n  const attachments = message.attachments\n  const hasAttachments = attachments.length > 0\n\n  // Build the text envelope first (same logic as before).\n  let envelopeText: string\n  let nameField: string | undefined\n  let role: 'user' | 'assistant'\n  if (message.role === 'user') {\n    role = 'user'\n    if (identifier.length === 0) {\n      envelopeText = text\n    } else {\n      nameField = sanitiseNameField(identifier)\n      const fromAttr = escapeXmlAttribute(representation)\n      envelopeText = `<message_${message.id} from=\"${fromAttr}\" role=\"user\"${createdAtAttr}>\\n${text}\\n</message_${message.id}>`\n    }\n  } else {\n    role = 'assistant'\n    if (identifier.length === 0 || identifier === selfIdentity) {\n      if (identifier.length > 0) {\n        nameField = sanitiseNameField(identifier)\n      }\n      envelopeText = text\n    } else {\n      nameField = sanitiseNameField(identifier)\n      const fromAttr = escapeXmlAttribute(representation)\n      envelopeText = `<peer_agent_output_${message.id} from=\"${fromAttr}\"${createdAtAttr}>\\n${text}\\n</peer_agent_output_${message.id}>`\n    }\n  }\n\n  if (!hasAttachments) {\n    const out: ChatCompletionsMessage = { role, content: envelopeText }\n    if (nameField !== undefined) out.name = nameField\n    return out\n  }\n\n  // Content-array path: text first (when present), then attachment blocks in array order.\n  const blocks: ChatCompletionsContentBlock[] = []\n  if (text.length > 0) {\n    blocks.push({ type: 'text', text: envelopeText })\n  }\n  for (const media of attachments) {\n    const mediaBlocks = await renderMediaToContentBlocks({\n      media,\n      toolName: undefined,\n      nonce: message.id,\n      unsupportedMediaPolicy,\n      renderTrustedContent,\n      renderUntrustedContent,\n      warn,\n    })\n    for (const b of mediaBlocks) blocks.push(b)\n  }\n  const out: ChatCompletionsMessage = { role, content: blocks }\n  if (nameField !== undefined) out.name = nameField\n  return out\n}\n/** Default timeline-message renderer; alias of {@link renderTimelineMessage}. */\nexport const defaultRenderTimelineMessage = renderTimelineMessage\n\n// ─── renderChatCompletionsToolCallResult ──────────────────────────────────────\n\nconst isSpooledArtifactResult = (\n  results: SpooledArtifact | Tokenizable\n): results is SpooledArtifact =>\n  isInstanceOf(results, 'SpooledArtifact') ||\n  // Subclasses identify via the base class guard upstream\n  ((results as unknown as { constructor?: { isSpooledArtifactConstructor?: boolean } })\n    ?.constructor !== null &&\n    (results as unknown as { constructor?: { isSpooledArtifactConstructor?: boolean } })\n      ?.constructor !== undefined &&\n    typeof (\n      results as unknown as {\n        constructor: { isSpooledArtifactConstructor?: (c: unknown) => boolean }\n      }\n    ).constructor.isSpooledArtifactConstructor === 'function')\n\nconst looksLikeSpooledArtifact = (value: unknown): value is SpooledArtifact => {\n  if (!value || typeof value !== 'object') return false\n  const v = value as Record<string, unknown>\n  return (\n    typeof v.asString === 'function' &&\n    typeof v.byteLength === 'function' &&\n    typeof v.lineCount === 'function' &&\n    typeof v.estimateTokens === 'function'\n  )\n}\n\nconst renderArtifactHandleBody = (\n  toolCall: ToolCall,\n  artifact: SpooledArtifact,\n  byteLength: number,\n  lineCount: number,\n  estimatedTokens: number | undefined,\n  encoding: string | undefined\n): string => {\n  const ctor = (\n    artifact as unknown as {\n      constructor: { toolMethods?: ReadonlyArray<{ name: string; description?: string }> }\n    }\n  ).constructor\n  const methods = ctor?.toolMethods ?? []\n  const lines: string[] = []\n  lines.push(`This tool returned a large artifact that was not inlined to preserve context budget.`)\n  lines.push(``)\n  lines.push(`Artifact metadata:`)\n  lines.push(`- callId: ${toolCall.id}`)\n  lines.push(`- kind: ${ctor?.constructor?.name ?? 'SpooledArtifact'}`)\n  lines.push(`- byteLength: ${byteLength}`)\n  lines.push(`- lineCount: ${lineCount}`)\n  if (estimatedTokens !== undefined && encoding) {\n    lines.push(`- estimatedTokens: ${estimatedTokens} (encoding: ${encoding})`)\n  }\n  lines.push(``)\n  lines.push(`To read this artifact in this turn, call one of the following tools with`)\n  lines.push(`callId=${toolCall.id}:`)\n  for (const m of methods) {\n    if (m.description) {\n      lines.push(`- ${m.name} — ${m.description}`)\n    } else {\n      lines.push(`- ${m.name}`)\n    }\n  }\n  lines.push(``)\n  lines.push(\n    `The artifact persists in this turn's context — multiple queries against the same callId are allowed and efficient. Do not assume the body has been inlined anywhere else.`\n  )\n  return lines.join('\\n')\n}\n\n/**\n * Renders a tool call's result(s) into the OpenAI Chat Completions tool-message body — either a\n * plain string or an array of content blocks when the result carries media — wrapping textual\n * output in the trust envelope appropriate to the tool's trust level.\n */\nexport const renderChatCompletionsToolCallResult = async (input: {\n  toolCall: ToolCall\n  results: Tokenizable | SpooledArtifact | SpooledArtifact[] | Media | Media[]\n  tool: Tool | ArtifactTool | undefined\n  renderUntrustedContent: ChatHelpersCommon['renderUntrustedContent']\n  renderTrustedContent: ChatHelpersCommon['renderTrustedContent']\n  unsupportedMediaPolicy: UnsupportedMediaPolicy\n  warn?: (msg: string) => void\n}): Promise<string | ChatCompletionsContentBlock[]> => {\n  const { toolCall, results, tool, warn, unsupportedMediaPolicy } = input\n  const isTrusted =\n    tool !== null && tool !== undefined && (tool as { trusted?: boolean }).trusted === true\n\n  if (tool === undefined) {\n    warn?.(\n      `Tool \"${toolCall.tool}\" is not present in the bound tool registry at render time; defaulting to untrusted envelope.`\n    )\n  }\n\n  // Media / Media[] silo — bypasses Tool.trusted (Trust-Is-Content rule). Envelope is sourced\n  // from each Media's own trustTier; modality from each Media's modalityHazard.\n  const isMediaResult = Media.isMedia(results)\n  const isMediaArrayResult =\n    Array.isArray(results) && results.length > 0 && results.every((r) => Media.isMedia(r))\n  if (isMediaResult || isMediaArrayResult) {\n    const mediaList = isMediaResult ? [results as Media] : (results as Media[])\n    const blocks: ChatCompletionsContentBlock[] = []\n    for (const media of mediaList) {\n      const mediaBlocks = await renderMediaToContentBlocks({\n        media,\n        toolName: toolCall.tool,\n        nonce: toolCall.checksum,\n        unsupportedMediaPolicy,\n        renderTrustedContent: input.renderTrustedContent,\n        renderUntrustedContent: input.renderUntrustedContent,\n        warn,\n      })\n      for (const b of mediaBlocks) blocks.push(b)\n    }\n    return blocks\n  }\n\n  // SpooledArtifact[] silo — render each artifact through the existing single-artifact path\n  // and concatenate the bodies. Trust envelope is decided per-artifact via the surrounding\n  // Tool.trusted flag (same as single SpooledArtifact today).\n  if (Array.isArray(results)) {\n    const parts: string[] = []\n    for (const a of results) {\n      const body = await (a as SpooledArtifact).asString()\n      parts.push(body)\n    }\n    const joined = parts.join('\\n\\n')\n    if (isTrusted) {\n      return input.renderTrustedContent(joined, {\n        nonce: toolCall.checksum,\n        kind: 'trusted-tool-result',\n        tool: toolCall.tool,\n      })\n    }\n    return input.renderUntrustedContent(joined, {\n      nonce: toolCall.checksum,\n      kind: 'tool-result',\n      tool: toolCall.tool,\n    })\n  }\n\n  const isSpooled = looksLikeSpooledArtifact(results)\n\n  // Handle-pattern branch: spooled + inline=false → always untrusted (queryable-data, not policy).\n  if (isSpooled && toolCall.inline === false) {\n    const artifact = results as SpooledArtifact\n    let byteLength = 0\n    let lineCount = 0\n    try {\n      byteLength = await artifact.byteLength()\n    } catch {\n      byteLength = 0\n    }\n    try {\n      lineCount = await artifact.lineCount()\n    } catch {\n      lineCount = 0\n    }\n    const body = renderArtifactHandleBody(\n      toolCall,\n      artifact,\n      byteLength,\n      lineCount,\n      undefined,\n      undefined\n    )\n    return input.renderUntrustedContent(body, {\n      nonce: toolCall.checksum,\n      kind: 'artifact-handle',\n      tool: toolCall.tool,\n    })\n  }\n\n  // Inline path: render full body via the appropriate envelope.\n  if (!isSpooled && toolCall.inline === false) {\n    warn?.(\n      `Tool call ${toolCall.id} has inline=false but results is a Tokenizable (not a SpooledArtifact); rendering inline anyway.`\n    )\n  }\n\n  let body: string\n  if (isSpooled) {\n    body = await (results as SpooledArtifact).asString()\n  } else {\n    body = (results as Tokenizable).toString()\n  }\n\n  if (isTrusted) {\n    return input.renderTrustedContent(body, {\n      nonce: toolCall.checksum,\n      kind: 'trusted-tool-result',\n      tool: toolCall.tool,\n    })\n  }\n  return input.renderUntrustedContent(body, {\n    nonce: toolCall.checksum,\n    kind: 'tool-result',\n    tool: toolCall.tool,\n  })\n}\n/** Default tool-call-result renderer; alias of {@link renderChatCompletionsToolCallResult}. */\nexport const defaultRenderChatCompletionsToolCallResult = renderChatCompletionsToolCallResult\n\n// suppress unused; kept for forward-compat with stricter spool guards\nvoid isSpooledArtifactResult\n\n// ─── buildChatCompletionsHistory ──────────────────────────────────────────────\n\ntype TimelineItem =\n  | { kind: 'message'; createdAt: number; value: Message }\n  | { kind: 'thought'; createdAt: number; value: Thought }\n  | { kind: 'toolCall'; createdAt: number; value: ToolCall }\n\n/**\n * Assembles the complete OpenAI Chat Completions message history for a dispatch — system prompt and\n * content buckets, the interleaved timeline of messages/thoughts/tool calls (with synthetic\n * `assistant.tool_calls` and `tool.tool_call_id` shaping), and the collected opaque reasoning\n * payloads — by delegating to the injected sub-renderers.\n */\nexport const buildChatCompletionsHistory = async (input: {\n  systemPrompt: Tokenizable\n  standingInstructions: Iterable<Tokenizable>\n  memories: Iterable<Memory>\n  retrievables: Iterable<Retrievable>\n  messages: Iterable<Message>\n  thoughts: Iterable<Thought>\n  toolCalls: Iterable<ToolCall>\n  tools: ToolRegistry\n  renderedToolCallResults: Map<string, string | ChatCompletionsContentBlock[]>\n  bucketOrder: ChatCompletionsBucketOrder\n  selfIdentity: string\n  thoughtSurfacing: 'all-self' | 'latest-self' | 'all'\n  replayCompatibility: ReadonlyArray<string>\n  unsupportedMediaPolicy: UnsupportedMediaPolicy\n  renderChatCompletionsToolCallResult: ChatCompletionsHelpers['renderChatCompletionsToolCallResult']\n  renderChatCompletionsSystemPrompt: ChatHelpersCommon['renderChatCompletionsSystemPrompt']\n  renderStandingInstructions: ChatHelpersCommon['renderStandingInstructions']\n  renderMemories: ChatHelpersCommon['renderMemories']\n  renderRetrievables: ChatHelpersCommon['renderRetrievables']\n  renderRetrievableSafetyDirective: ChatHelpersCommon['renderRetrievableSafetyDirective']\n  renderFirstPartyRetrievables: ChatHelpersCommon['renderFirstPartyRetrievables']\n  renderThirdPartyPublicRetrievables: ChatHelpersCommon['renderThirdPartyPublicRetrievables']\n  renderThirdPartyPrivateRetrievables: ChatHelpersCommon['renderThirdPartyPrivateRetrievables']\n  renderTimelineMessage: ChatCompletionsHelpers['renderTimelineMessage']\n  renderThought: ChatHelpersCommon['renderThought']\n  filterThoughts: ChatHelpersCommon['filterThoughts']\n  renderUntrustedContent: ChatHelpersCommon['renderUntrustedContent']\n  renderTrustedContent: ChatHelpersCommon['renderTrustedContent']\n  warn?: (msg: string) => void\n}): Promise<{\n  messages: ChatCompletionsMessage[]\n  reasoningPayloads: Array<{ id: string; replayCompatibility: string; payload: unknown }>\n}> => {\n  const out: ChatCompletionsMessage[] = []\n  const reasoningPayloads: Array<{\n    id: string\n    replayCompatibility: string\n    payload: unknown\n  }> = []\n\n  const buckets = input.bucketOrder\n  const timelineIdx = buckets.indexOf('timeline')\n\n  // Build leading system content from base prompt + before-timeline buckets.\n  const leadingSystem = await input.renderChatCompletionsSystemPrompt({\n    systemPrompt: input.systemPrompt,\n    standingInstructions: input.standingInstructions,\n    memories: input.memories,\n    retrievables: input.retrievables,\n    bucketOrder: buckets,\n    renderStandingInstructions: input.renderStandingInstructions,\n    renderMemories: input.renderMemories,\n    renderRetrievables: input.renderRetrievables,\n    renderRetrievableSafetyDirective: input.renderRetrievableSafetyDirective,\n    renderFirstPartyRetrievables: input.renderFirstPartyRetrievables,\n    renderThirdPartyPublicRetrievables: input.renderThirdPartyPublicRetrievables,\n    renderThirdPartyPrivateRetrievables: input.renderThirdPartyPrivateRetrievables,\n    renderUntrustedContent: input.renderUntrustedContent,\n  })\n  if (leadingSystem.length > 0) {\n    out.push({ role: 'system', content: leadingSystem })\n  }\n\n  // Build the timeline (if present in bucketOrder).\n  const includesTimeline = timelineIdx !== -1\n  if (includesTimeline) {\n    // Filter thoughts per surfacing mode + compatibility.\n    const survivingThoughts = input.filterThoughts(\n      input.thoughts,\n      input.thoughtSurfacing,\n      input.selfIdentity,\n      input.replayCompatibility\n    )\n\n    // Build sorted timeline items.\n    const items: TimelineItem[] = []\n    for (const m of input.messages) {\n      items.push({ kind: 'message', createdAt: m.createdAt.toMillis(), value: m })\n    }\n    for (const t of survivingThoughts) {\n      items.push({ kind: 'thought', createdAt: t.createdAt.toMillis(), value: t })\n    }\n    for (const tc of input.toolCalls) {\n      items.push({ kind: 'toolCall', createdAt: tc.createdAt.toMillis(), value: tc })\n    }\n    items.sort((a, b) => a.createdAt - b.createdAt)\n\n    const replaySet = new Set<string>([...input.replayCompatibility])\n\n    for (const item of items) {\n      if (item.kind === 'message') {\n        out.push(\n          await input.renderTimelineMessage({\n            message: item.value,\n            selfIdentity: input.selfIdentity,\n            unsupportedMediaPolicy: input.unsupportedMediaPolicy,\n            warn: input.warn,\n          })\n        )\n      } else if (item.kind === 'thought') {\n        const t = item.value\n        const identifier = String(t.identity?.identifier ?? '')\n        const isSelf = identifier === input.selfIdentity\n        const hasPayload = t.payload !== undefined\n        const compatTag = t.replayCompatibility\n\n        if (hasPayload && compatTag && replaySet.has(compatTag)) {\n          // Opaque reasoning — side-channel + summary envelope.\n          reasoningPayloads.push({\n            id: t.id,\n            replayCompatibility: compatTag,\n            payload: t.payload,\n          })\n          const envelope = input.renderThought(\n            t.content.toString(),\n            {\n              nonce: t.id,\n              kind: 'opaque-reasoning',\n              from: identifier,\n              createdAt: t.createdAt?.toISO?.() ?? undefined,\n              replayCompatibility: compatTag,\n            },\n            t.payload\n          )\n          const synthetic: ChatCompletionsMessage = {\n            role: 'assistant',\n            content: envelope,\n          }\n          if (!isSelf && identifier.length > 0) {\n            synthetic.name = sanitiseNameField(identifier)\n          }\n          out.push(synthetic)\n        } else if (!hasPayload) {\n          // Plain-text reasoning (no payload, or tagged plain-text, or tagged but matched).\n          const envelope = input.renderThought(t.content.toString(), {\n            nonce: t.id,\n            kind: isSelf ? 'self-reasoning' : 'peer-reasoning',\n            from: identifier,\n            createdAt: t.createdAt?.toISO?.() ?? undefined,\n          })\n          const synthetic: ChatCompletionsMessage = {\n            role: 'assistant',\n            content: envelope,\n          }\n          if (!isSelf && identifier.length > 0) {\n            synthetic.name = sanitiseNameField(identifier)\n          }\n          out.push(synthetic)\n        }\n        // else: opaque, non-matching → elided (NOT removed from ctx.turnThoughts upstream).\n      } else {\n        // tool call: emit a synthetic assistant message carrying tool_calls[],\n        // followed by a tool-role message with the result.\n        const tc = item.value\n        const assistantMsg: ChatCompletionsMessage = {\n          role: 'assistant',\n          content: null,\n          tool_calls: [\n            {\n              id: tc.id,\n              type: 'function',\n              function: {\n                name: tc.tool,\n                arguments: typeof tc.args === 'string' ? tc.args : JSON.stringify(tc.args ?? {}),\n              },\n            },\n          ],\n        }\n        out.push(assistantMsg)\n\n        let rendered = input.renderedToolCallResults.get(tc.id)\n        if (rendered === undefined) {\n          const tool = input.tools.get?.(tc.tool)\n          rendered = await input.renderChatCompletionsToolCallResult({\n            toolCall: tc,\n            results: tc.results as\n              | Tokenizable\n              | SpooledArtifact\n              | SpooledArtifact[]\n              | Media\n              | Media[],\n            tool: tool as Tool | ArtifactTool | undefined,\n            renderUntrustedContent: input.renderUntrustedContent,\n            renderTrustedContent: input.renderTrustedContent,\n            unsupportedMediaPolicy: input.unsupportedMediaPolicy,\n            warn: input.warn,\n          })\n        }\n        out.push({\n          role: 'tool',\n          content: rendered,\n          tool_call_id: tc.id,\n        })\n      }\n    }\n  }\n\n  // Trailing system message for after-timeline buckets.\n  if (includesTimeline) {\n    const trailingParts: string[] = []\n    for (let i = timelineIdx + 1; i < buckets.length; i++) {\n      const label = buckets[i]!\n      if (label === 'standingInstructions') {\n        const block = input.renderStandingInstructions(input.standingInstructions)\n        if (block.length > 0) trailingParts.push(block)\n      } else if (label === 'memories') {\n        const wrapped: Array<{ memory: Memory; attrs: MemoryAttrs }> = []\n        for (const m of input.memories) {\n          wrapped.push(memoryToAttrs(m))\n        }\n        const block = input.renderMemories(wrapped)\n        if (block.length > 0) trailingParts.push(block)\n      } else if (label === 'retrievables') {\n        const wrapped: Array<{ retrievable: Retrievable; attrs: RetrievableAttrs }> = []\n        for (const r of input.retrievables) {\n          wrapped.push(retrievableToAttrs(r))\n        }\n        const block = await input.renderRetrievables(wrapped, {\n          renderRetrievableSafetyDirective: input.renderRetrievableSafetyDirective,\n          renderFirstPartyRetrievables: input.renderFirstPartyRetrievables,\n          renderThirdPartyPublicRetrievables: input.renderThirdPartyPublicRetrievables,\n          renderThirdPartyPrivateRetrievables: input.renderThirdPartyPrivateRetrievables,\n          renderUntrustedContent: input.renderUntrustedContent,\n        })\n        if (block.length > 0) trailingParts.push(block)\n      }\n    }\n    if (trailingParts.length > 0) {\n      out.push({ role: 'system', content: trailingParts.join('\\n\\n') })\n    }\n  }\n\n  return { messages: out, reasoningPayloads }\n}\n/** Default history assembler; alias of {@link buildChatCompletionsHistory}. */\nexport const defaultBuildChatCompletionsHistory = buildChatCompletionsHistory\n\n// ─── createChatCompletionsToolCallDeltaAccumulator ────────────────────────────\n\n/**\n * Creates a fresh accumulator that stitches streamed {@link ChatCompletionsToolCallDelta} fragments\n * (keyed by their stream index) into fully-assembled tool calls, drained once the stream completes.\n */\nexport const createChatCompletionsToolCallDeltaAccumulator =\n  (): ChatCompletionsToolCallDeltaAccumulator => {\n    const byIndex = new Map<\n      number,\n      { id?: string; type?: 'function'; name: string; args: string }\n    >()\n    return {\n      feed(delta: ChatCompletionsToolCallDelta): void {\n        const idx = delta.index\n        let entry = byIndex.get(idx)\n        if (!entry) {\n          entry = { name: '', args: '' }\n          byIndex.set(idx, entry)\n        }\n        if (delta.id !== undefined) entry.id = delta.id\n        if (delta.type !== undefined) entry.type = delta.type\n        if (delta.function?.name !== undefined) {\n          entry.name = entry.name + delta.function.name\n        }\n        if (delta.function?.arguments !== undefined) {\n          entry.args = entry.args + delta.function.arguments\n        }\n      },\n      drain(): AssembledToolCall[] {\n        const out: AssembledToolCall[] = []\n        const indices = Array.from(byIndex.keys()).sort((a, b) => a - b)\n        for (const idx of indices) {\n          const e = byIndex.get(idx)!\n          out.push({\n            id: e.id ?? `call_${idx}`,\n            type: e.type ?? 'function',\n            name: e.name,\n            args: e.args,\n          })\n        }\n        return out\n      },\n    }\n  }\n/** Default delta-accumulator factory; alias of {@link createChatCompletionsToolCallDeltaAccumulator}. */\nexport const defaultCreateChatCompletionsToolCallDeltaAccumulator =\n  createChatCompletionsToolCallDeltaAccumulator\n"],"mappings":"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"}
+{"version":3,"file":"helpers.mjs","names":[],"sources":["../../../../src/batteries/llm/openai_chat_completions/helpers.ts"],"sourcesContent":["/**\n * Swappable translation helpers for rendering ADK state into Chat Completions requests.\n *\n * @module @nhtio/adk/batteries/llm/openai_chat_completions/helpers\n *\n * @remarks\n * The swappable translation helpers that turn ADK primitives into OpenAI Chat Completions wire\n * shapes. Each helper is exported under its unprefixed name AND under a `default*` alias so\n * consumers can compose partial overrides. Helpers that compose other helpers receive their\n * dependents via explicit input arguments — never via module-level closure — so a swap at any\n * layer propagates correctly.\n *\n * The wire-shape-AGNOSTIC helpers (`renderUntrustedContent`, `renderMemories`,\n * `renderChatCompletionsSystemPrompt`, `toolsToChatCompletionsTools`, …) now live in the shared,\n * internal `../chat_common/helpers` submodule and are re-exported here under their original names\n * so every existing import keeps resolving. Only the OpenAI-WIRE-SPECIFIC helpers\n * (`renderTimelineMessage`, `renderChatCompletionsToolCallResult`, `buildChatCompletionsHistory`,\n * `createChatCompletionsToolCallDeltaAccumulator`) and the reasoning-field extractor are defined\n * here.\n */\n\nimport { Media } from '@nhtio/adk/common'\nimport { isInstanceOf } from '@nhtio/adk/guards'\nimport { E_UNSUPPORTED_MEDIA_MODALITY } from './exceptions'\nimport {\n  escapeXmlAttribute,\n  sanitiseNameField,\n  memoryToAttrs,\n  retrievableToAttrs,\n  renderTrustedContent,\n  renderUntrustedContent,\n} from '../chat_common/helpers'\nimport type { ChatHelpersCommon } from '../chat_common/types'\nimport type {\n  Tool,\n  ArtifactTool,\n  ToolRegistry,\n  Tokenizable,\n  Memory,\n  Message,\n  Thought,\n  ToolCall,\n  Retrievable,\n  SpooledArtifact,\n  MediaModalityHazard,\n  MediaStashEntry,\n} from '@nhtio/adk/common'\nimport type {\n  ChatCompletionsMessage,\n  ChatCompletionsContentBlock,\n  ChatCompletionsToolCallDelta,\n  ChatCompletionsToolCallDeltaAccumulator,\n  AssembledToolCall,\n  ChatCompletionsBucketOrder,\n  MemoryAttrs,\n  RetrievableAttrs,\n  ChatCompletionsHelpers,\n  UnsupportedMediaPolicy,\n  ReasoningField,\n  ReasoningFieldPrecedence,\n  ReasoningExtract,\n} from './types'\n\n// ─── Re-exported wire-shape-agnostic helpers (shared submodule) ───────────────\n// These are defined once in `../chat_common/helpers` and shared with the native Ollama battery.\n// Re-exported here (bare + `default*`) so every existing\n// `@nhtio/adk/batteries/llm/openai_chat_completions` import keeps resolving unchanged.\nexport {\n  descriptionToChatCompletionsJsonSchema,\n  defaultDescriptionToChatCompletionsJsonSchema,\n  renderUntrustedContent,\n  defaultRenderUntrustedContent,\n  renderTrustedContent,\n  defaultRenderTrustedContent,\n  renderStandingInstructions,\n  defaultRenderStandingInstructions,\n  renderMemories,\n  defaultRenderMemories,\n  renderRetrievableSafetyDirective,\n  defaultRenderRetrievableSafetyDirective,\n  renderFirstPartyRetrievables,\n  defaultRenderFirstPartyRetrievables,\n  renderThirdPartyPublicRetrievables,\n  defaultRenderThirdPartyPublicRetrievables,\n  renderThirdPartyPrivateRetrievables,\n  defaultRenderThirdPartyPrivateRetrievables,\n  renderRetrievables,\n  defaultRenderRetrievables,\n  renderThought,\n  defaultRenderThought,\n  filterThoughts,\n  defaultFilterThoughts,\n  toolsToChatCompletionsTools,\n  defaultToolsToChatCompletionsTools,\n  renderChatCompletionsSystemPrompt,\n  defaultRenderChatCompletionsSystemPrompt,\n} from '../chat_common/helpers'\n\n// ─── extractReasoningFields ───────────────────────────────────────────────────\n\n/**\n * Pulls model reasoning/thinking text out of a Chat Completions response message or stream delta,\n * reading every wire field named in `precedence` that carries a non-empty string.\n *\n * @remarks\n * Reasoning is not part of OpenAI's official Chat Completions spec, so OpenAI-compatible providers\n * disagree on the field name (`reasoning` for Ollama and current vLLM; `reasoning_content` for\n * legacy vLLM and DeepSeek). This reads the union, in `precedence` order, and de-duplicates by\n * content value: a field whose text exactly matches one already kept is dropped.\n *\n * The result length encodes the emission rule the callers follow:\n * - `0` — no reasoning present.\n * - `1` — a single thought (covers \"only one field present\" AND \"several present but identical\").\n * - `≥2` — divergent fields; each surfaces as its own thought rather than silently dropping one.\n *\n * @param src - The response `message` or stream `delta` to read from.\n * @param precedence - Ordered, de-duplicated field names to read (see `reasoningFieldPrecedence`).\n * @returns The present, content-deduplicated reasoning traces in precedence order.\n */\nexport const extractReasoningFields = (\n  src: Partial<Record<ReasoningField, string | null | undefined>> | undefined,\n  precedence: ReasoningFieldPrecedence\n): ReasoningExtract[] => {\n  const out: ReasoningExtract[] = []\n  for (const field of precedence) {\n    const value = src?.[field]\n    if (typeof value !== 'string' || value.length === 0) continue\n    if (out.some((e) => e.content === value)) continue\n    out.push({ field, content: value })\n  }\n  return out\n}\n\n// ─── Media rendering helpers (OpenAI content-block specific) ──────────────────\n\nconst DEFAULT_STASH_FALLBACK_KEYS: ReadonlyArray<string> = [\n  'text:transcript',\n  'text:caption',\n  'text:description',\n]\n\nconst modalityHazardToAttr = (h: MediaModalityHazard): 'inert' | 'extractable' | 'opaque' => {\n  if (h === 'inert') return 'inert'\n  if (h === 'extractable-instructions') return 'extractable'\n  return 'opaque'\n}\n\nconst formatBytesHumanReadable = (bytes: number | undefined): string => {\n  if (bytes === undefined || !Number.isFinite(bytes)) return 'unknown size'\n  if (bytes < 1024) return `${bytes} B`\n  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`\n  if (bytes < 1024 * 1024 * 1024) return `${(bytes / (1024 * 1024)).toFixed(1)} MB`\n  return `${(bytes / (1024 * 1024 * 1024)).toFixed(1)} GB`\n}\n\nconst audioFormatFromMime = (mime: string): 'wav' | 'mp3' | undefined => {\n  const m = mime.toLowerCase()\n  if (m.includes('wav') || m.includes('x-wav') || m.includes('wave')) return 'wav'\n  if (m.includes('mpeg') || m.includes('mp3')) return 'mp3'\n  return undefined\n}\n\nconst isMediaTextStashEntry = (e: unknown): e is MediaStashEntry => {\n  if (!e || typeof e !== 'object') return false\n  const r = e as Record<string, unknown>\n  return typeof r.value === 'string' && typeof r.trustTier === 'string'\n}\n\nconst resolveFallbackStash = (\n  media: Media,\n  keys: ReadonlyArray<string>\n): { text: string; entryTier: MediaStashEntry['trustTier'] } | undefined => {\n  for (const key of keys) {\n    const entry = media.stash.get(key)\n    if (isMediaTextStashEntry(entry)) {\n      return { text: entry.value as string, entryTier: entry.trustTier }\n    }\n  }\n  return undefined\n}\n\nconst renderTextInEnvelope = (\n  text: string,\n  args: {\n    trustTier: MediaStashEntry['trustTier']\n    modality: 'inert' | 'extractable' | 'opaque'\n    nonce: string\n    toolName: string | undefined\n    renderTrustedContent: ChatHelpersCommon['renderTrustedContent']\n    renderUntrustedContent: ChatHelpersCommon['renderUntrustedContent']\n  }\n): string => {\n  if (args.trustTier === 'first-party') {\n    return args.renderTrustedContent(text, {\n      nonce: args.nonce,\n      kind: 'media-fallback',\n      tool: args.toolName,\n      modality: args.modality,\n    })\n  }\n  return args.renderUntrustedContent(text, {\n    nonce: args.nonce,\n    kind: 'media-fallback',\n    tool: args.toolName,\n    modality: args.modality,\n  })\n}\n\nconst renderSyntheticMediaDescription = (media: Media, byteLen: number | undefined): string =>\n  `[media: ${media.filename}, ${media.mimeType}, ${formatBytesHumanReadable(byteLen)}]`\n\n/**\n * The inline media id-marker: a harness-authored text block rendered immediately BEFORE each\n * media content block, so the model can reference the media by id in subsequent tool calls\n * (`media_id` args, `@id` pipe refs).\n *\n * Trust posture: the marker is structural reference data authored by the harness from the\n * harness-controlled `Media.id` (a UUID, not derivable from the payload) — it is NOT payload\n * content, carries no authority, and deliberately renders OUTSIDE the untrusted envelope with\n * fixed, non-instruction phrasing. This is a documented cross-battery convention: every LLM\n * battery that renders media emits the same marker shape.\n */\nconst renderMediaIdMarker = (media: Media): string => `[media id: ${media.id} | ${media.filename}]`\n\nconst renderMediaToContentBlocks = async (input: {\n  media: Media\n  toolName: string | undefined\n  nonce: string\n  unsupportedMediaPolicy: UnsupportedMediaPolicy\n  renderTrustedContent: ChatHelpersCommon['renderTrustedContent']\n  renderUntrustedContent: ChatHelpersCommon['renderUntrustedContent']\n  warn?: (msg: string) => void\n}): Promise<ChatCompletionsContentBlock[]> => {\n  const blocks = await renderMediaBodyBlocks(input)\n  return [{ type: 'text', text: renderMediaIdMarker(input.media) }, ...blocks]\n}\n\nconst renderMediaBodyBlocks = async (input: {\n  media: Media\n  toolName: string | undefined\n  nonce: string\n  unsupportedMediaPolicy: UnsupportedMediaPolicy\n  renderTrustedContent: ChatHelpersCommon['renderTrustedContent']\n  renderUntrustedContent: ChatHelpersCommon['renderUntrustedContent']\n  warn?: (msg: string) => void\n}): Promise<ChatCompletionsContentBlock[]> => {\n  const { media, toolName, nonce, unsupportedMediaPolicy, warn } = input\n  const modality = modalityHazardToAttr(media.modalityHazard)\n  const kind = media.kind\n\n  const fallbackPath = async (\n    keys: ReadonlyArray<string>,\n    allowSyntheticFallthrough: boolean\n  ): Promise<ChatCompletionsContentBlock[]> => {\n    const fallback = resolveFallbackStash(media, keys)\n    if (fallback) {\n      const text = renderTextInEnvelope(fallback.text, {\n        trustTier: fallback.entryTier,\n        modality,\n        nonce,\n        toolName,\n        renderTrustedContent: input.renderTrustedContent,\n        renderUntrustedContent: input.renderUntrustedContent,\n      })\n      return [{ type: 'text', text }]\n    }\n    if (!allowSyntheticFallthrough) {\n      // 'fallback-stash' falls through to 'synthetic-description' when no entry is found.\n      warn?.(\n        `unsupportedMediaPolicy='fallback-stash' for ${media.filename}: no matching stash entry — falling through to synthetic description.`\n      )\n    }\n    const byteLen = await media.byteLength()\n    const text = renderTextInEnvelope(renderSyntheticMediaDescription(media, byteLen), {\n      trustTier: media.trustTier,\n      modality,\n      nonce,\n      toolName,\n      renderTrustedContent: input.renderTrustedContent,\n      renderUntrustedContent: input.renderUntrustedContent,\n    })\n    return [{ type: 'text', text }]\n  }\n\n  if (kind === 'image') {\n    const b64 = await media.asBase64()\n    return [\n      {\n        type: 'image_url',\n        image_url: { url: `data:${media.mimeType};base64,${b64}` },\n      },\n    ]\n  }\n\n  if (kind === 'audio') {\n    const fmt = audioFormatFromMime(media.mimeType)\n    if (fmt === undefined) {\n      // Audio mime not natively expressible — same policy path as video.\n      if (unsupportedMediaPolicy === 'throw') {\n        throw new E_UNSUPPORTED_MEDIA_MODALITY([media.kind, media.mimeType, media.filename])\n      }\n      if (\n        unsupportedMediaPolicy === 'fallback-stash' ||\n        (typeof unsupportedMediaPolicy === 'object' &&\n          unsupportedMediaPolicy.mode === 'fallback-stash')\n      ) {\n        const keys =\n          typeof unsupportedMediaPolicy === 'object'\n            ? unsupportedMediaPolicy.stashKeys\n            : DEFAULT_STASH_FALLBACK_KEYS\n        return fallbackPath(keys, false)\n      }\n      return fallbackPath([], true)\n    }\n    const data = await media.asBase64()\n    return [\n      {\n        type: 'input_audio',\n        input_audio: { data, format: fmt },\n      },\n    ]\n  }\n\n  if (kind === 'document') {\n    const b64 = await media.asBase64()\n    return [\n      {\n        type: 'file',\n        file: {\n          filename: media.filename,\n          file_data: `data:${media.mimeType};base64,${b64}`,\n        },\n      },\n    ]\n  }\n\n  // kind === 'video' — not natively supported by Chat Completions wire format.\n  if (unsupportedMediaPolicy === 'throw') {\n    throw new E_UNSUPPORTED_MEDIA_MODALITY([media.kind, media.mimeType, media.filename])\n  }\n  if (\n    unsupportedMediaPolicy === 'fallback-stash' ||\n    (typeof unsupportedMediaPolicy === 'object' && unsupportedMediaPolicy.mode === 'fallback-stash')\n  ) {\n    const keys =\n      typeof unsupportedMediaPolicy === 'object'\n        ? unsupportedMediaPolicy.stashKeys\n        : DEFAULT_STASH_FALLBACK_KEYS\n    return fallbackPath(keys, false)\n  }\n  return fallbackPath([], true)\n}\n\n// ─── renderTimelineMessage ────────────────────────────────────────────────────\n\n/**\n * Renders a single timeline {@link @nhtio/adk!Message} into an OpenAI Chat Completions message —\n * mapping media to content blocks (`image_url` / `input_audio` / `file`), wrapping textual bodies\n * in the appropriate trust envelope, and applying the unsupported-media policy.\n */\nexport const renderTimelineMessage = async (input: {\n  message: Message\n  selfIdentity: string\n  unsupportedMediaPolicy: UnsupportedMediaPolicy\n  warn?: (msg: string) => void\n}): Promise<ChatCompletionsMessage> => {\n  const { message, selfIdentity, unsupportedMediaPolicy, warn } = input\n  const identifier =\n    message.identity?.identifier !== undefined && message.identity?.identifier !== null\n      ? String(message.identity.identifier)\n      : ''\n  const representationRaw =\n    message.identity?.representation !== undefined && message.identity?.representation !== null\n      ? message.identity.representation.toString()\n      : ''\n  // Prompt-facing identity (the `from=` attribute) reads `representation`;\n  // structural `messages[].name` reads `identifier`. Fall back to `identifier`\n  // when `representation` is empty so a bare-string identity still renders.\n  const representation = representationRaw.length > 0 ? representationRaw : identifier\n  const text = message.content !== undefined ? message.content.toString() : ''\n  const createdAtStr = message.createdAt.toISO?.() ?? ''\n  const createdAtAttr = createdAtStr ? ` createdAt=\"${escapeXmlAttribute(createdAtStr)}\"` : ''\n  const attachments = message.attachments\n  const hasAttachments = attachments.length > 0\n\n  // Build the text envelope first (same logic as before).\n  let envelopeText: string\n  let nameField: string | undefined\n  let role: 'user' | 'assistant'\n  if (message.role === 'user') {\n    role = 'user'\n    if (identifier.length === 0) {\n      envelopeText = text\n    } else {\n      nameField = sanitiseNameField(identifier)\n      const fromAttr = escapeXmlAttribute(representation)\n      envelopeText = `<message_${message.id} from=\"${fromAttr}\" role=\"user\"${createdAtAttr}>\\n${text}\\n</message_${message.id}>`\n    }\n  } else {\n    role = 'assistant'\n    if (identifier.length === 0 || identifier === selfIdentity) {\n      if (identifier.length > 0) {\n        nameField = sanitiseNameField(identifier)\n      }\n      envelopeText = text\n    } else {\n      nameField = sanitiseNameField(identifier)\n      const fromAttr = escapeXmlAttribute(representation)\n      envelopeText = `<peer_agent_output_${message.id} from=\"${fromAttr}\"${createdAtAttr}>\\n${text}\\n</peer_agent_output_${message.id}>`\n    }\n  }\n\n  if (!hasAttachments) {\n    const out: ChatCompletionsMessage = { role, content: envelopeText }\n    if (nameField !== undefined) out.name = nameField\n    return out\n  }\n\n  // Content-array path: text first (when present), then attachment blocks in array order.\n  const blocks: ChatCompletionsContentBlock[] = []\n  if (text.length > 0) {\n    blocks.push({ type: 'text', text: envelopeText })\n  }\n  for (const media of attachments) {\n    const mediaBlocks = await renderMediaToContentBlocks({\n      media,\n      toolName: undefined,\n      nonce: message.id,\n      unsupportedMediaPolicy,\n      renderTrustedContent,\n      renderUntrustedContent,\n      warn,\n    })\n    for (const b of mediaBlocks) blocks.push(b)\n  }\n  const out: ChatCompletionsMessage = { role, content: blocks }\n  if (nameField !== undefined) out.name = nameField\n  return out\n}\n/** Default timeline-message renderer; alias of {@link renderTimelineMessage}. */\nexport const defaultRenderTimelineMessage = renderTimelineMessage\n\n// ─── renderChatCompletionsToolCallResult ──────────────────────────────────────\n\nconst isSpooledArtifactResult = (\n  results: SpooledArtifact | Tokenizable\n): results is SpooledArtifact =>\n  isInstanceOf(results, 'SpooledArtifact') ||\n  // Subclasses identify via the base class guard upstream\n  ((results as unknown as { constructor?: { isSpooledArtifactConstructor?: boolean } })\n    ?.constructor !== null &&\n    (results as unknown as { constructor?: { isSpooledArtifactConstructor?: boolean } })\n      ?.constructor !== undefined &&\n    typeof (\n      results as unknown as {\n        constructor: { isSpooledArtifactConstructor?: (c: unknown) => boolean }\n      }\n    ).constructor.isSpooledArtifactConstructor === 'function')\n\nconst looksLikeSpooledArtifact = (value: unknown): value is SpooledArtifact => {\n  if (!value || typeof value !== 'object') return false\n  const v = value as Record<string, unknown>\n  return (\n    typeof v.asString === 'function' &&\n    typeof v.byteLength === 'function' &&\n    typeof v.lineCount === 'function' &&\n    typeof v.estimateTokens === 'function'\n  )\n}\n\nconst renderArtifactHandleBody = (\n  toolCall: ToolCall,\n  artifact: SpooledArtifact,\n  byteLength: number,\n  lineCount: number,\n  estimatedTokens: number | undefined,\n  encoding: string | undefined\n): string => {\n  const ctor = (\n    artifact as unknown as {\n      constructor: { toolMethods?: ReadonlyArray<{ name: string; description?: string }> }\n    }\n  ).constructor\n  const methods = ctor?.toolMethods ?? []\n  const lines: string[] = []\n  lines.push(`This tool returned a large artifact that was not inlined to preserve context budget.`)\n  lines.push(``)\n  lines.push(`Artifact metadata:`)\n  lines.push(`- callId: ${toolCall.id}`)\n  lines.push(`- kind: ${ctor?.constructor?.name ?? 'SpooledArtifact'}`)\n  lines.push(`- byteLength: ${byteLength}`)\n  lines.push(`- lineCount: ${lineCount}`)\n  if (estimatedTokens !== undefined && encoding) {\n    lines.push(`- estimatedTokens: ${estimatedTokens} (encoding: ${encoding})`)\n  }\n  lines.push(``)\n  lines.push(`To read this artifact in this turn, call one of the following tools with`)\n  lines.push(`callId=${toolCall.id}:`)\n  for (const m of methods) {\n    if (m.description) {\n      lines.push(`- ${m.name} — ${m.description}`)\n    } else {\n      lines.push(`- ${m.name}`)\n    }\n  }\n  lines.push(``)\n  lines.push(\n    `The artifact persists in this turn's context — multiple queries against the same callId are allowed and efficient. Do not assume the body has been inlined anywhere else.`\n  )\n  return lines.join('\\n')\n}\n\n/**\n * Renders a tool call's result(s) into the OpenAI Chat Completions tool-message body — either a\n * plain string or an array of content blocks when the result carries media — wrapping textual\n * output in the trust envelope appropriate to the tool's trust level.\n */\nexport const renderChatCompletionsToolCallResult = async (input: {\n  toolCall: ToolCall\n  results: Tokenizable | SpooledArtifact | SpooledArtifact[] | Media | Media[]\n  tool: Tool | ArtifactTool | undefined\n  renderUntrustedContent: ChatHelpersCommon['renderUntrustedContent']\n  renderTrustedContent: ChatHelpersCommon['renderTrustedContent']\n  unsupportedMediaPolicy: UnsupportedMediaPolicy\n  warn?: (msg: string) => void\n}): Promise<string | ChatCompletionsContentBlock[]> => {\n  const { toolCall, results, tool, warn, unsupportedMediaPolicy } = input\n  const isTrusted =\n    tool !== null && tool !== undefined && (tool as { trusted?: boolean }).trusted === true\n\n  if (tool === undefined) {\n    warn?.(\n      `Tool \"${toolCall.tool}\" is not present in the bound tool registry at render time; defaulting to untrusted envelope.`\n    )\n  }\n\n  // Media / Media[] silo — bypasses Tool.trusted (Trust-Is-Content rule). Envelope is sourced\n  // from each Media's own trustTier; modality from each Media's modalityHazard.\n  const isMediaResult = Media.isMedia(results)\n  const isMediaArrayResult =\n    Array.isArray(results) && results.length > 0 && results.every((r) => Media.isMedia(r))\n  if (isMediaResult || isMediaArrayResult) {\n    const mediaList = isMediaResult ? [results as Media] : (results as Media[])\n    const blocks: ChatCompletionsContentBlock[] = []\n    for (const media of mediaList) {\n      const mediaBlocks = await renderMediaToContentBlocks({\n        media,\n        toolName: toolCall.tool,\n        nonce: toolCall.checksum,\n        unsupportedMediaPolicy,\n        renderTrustedContent: input.renderTrustedContent,\n        renderUntrustedContent: input.renderUntrustedContent,\n        warn,\n      })\n      for (const b of mediaBlocks) blocks.push(b)\n    }\n    return blocks\n  }\n\n  // SpooledArtifact[] silo — render each artifact through the existing single-artifact path\n  // and concatenate the bodies. Trust envelope is decided per-artifact via the surrounding\n  // Tool.trusted flag (same as single SpooledArtifact today).\n  if (Array.isArray(results)) {\n    const parts: string[] = []\n    for (const a of results) {\n      const body = await (a as SpooledArtifact).asString()\n      parts.push(body)\n    }\n    const joined = parts.join('\\n\\n')\n    if (isTrusted) {\n      return input.renderTrustedContent(joined, {\n        nonce: toolCall.checksum,\n        kind: 'trusted-tool-result',\n        tool: toolCall.tool,\n      })\n    }\n    return input.renderUntrustedContent(joined, {\n      nonce: toolCall.checksum,\n      kind: 'tool-result',\n      tool: toolCall.tool,\n    })\n  }\n\n  const isSpooled = looksLikeSpooledArtifact(results)\n\n  // Handle-pattern branch: spooled + inline=false → always untrusted (queryable-data, not policy).\n  if (isSpooled && toolCall.inline === false) {\n    const artifact = results as SpooledArtifact\n    let byteLength = 0\n    let lineCount = 0\n    try {\n      byteLength = await artifact.byteLength()\n    } catch {\n      byteLength = 0\n    }\n    try {\n      lineCount = await artifact.lineCount()\n    } catch {\n      lineCount = 0\n    }\n    const body = renderArtifactHandleBody(\n      toolCall,\n      artifact,\n      byteLength,\n      lineCount,\n      undefined,\n      undefined\n    )\n    return input.renderUntrustedContent(body, {\n      nonce: toolCall.checksum,\n      kind: 'artifact-handle',\n      tool: toolCall.tool,\n    })\n  }\n\n  // Inline path: render full body via the appropriate envelope.\n  if (!isSpooled && toolCall.inline === false) {\n    warn?.(\n      `Tool call ${toolCall.id} has inline=false but results is a Tokenizable (not a SpooledArtifact); rendering inline anyway.`\n    )\n  }\n\n  let body: string\n  if (isSpooled) {\n    body = await (results as SpooledArtifact).asString()\n  } else {\n    body = (results as Tokenizable).toString()\n  }\n\n  if (isTrusted) {\n    return input.renderTrustedContent(body, {\n      nonce: toolCall.checksum,\n      kind: 'trusted-tool-result',\n      tool: toolCall.tool,\n    })\n  }\n  return input.renderUntrustedContent(body, {\n    nonce: toolCall.checksum,\n    kind: 'tool-result',\n    tool: toolCall.tool,\n  })\n}\n/** Default tool-call-result renderer; alias of {@link renderChatCompletionsToolCallResult}. */\nexport const defaultRenderChatCompletionsToolCallResult = renderChatCompletionsToolCallResult\n\n// suppress unused; kept for forward-compat with stricter spool guards\nvoid isSpooledArtifactResult\n\n// ─── buildChatCompletionsHistory ──────────────────────────────────────────────\n\ntype TimelineItem =\n  | { kind: 'message'; createdAt: number; value: Message }\n  | { kind: 'thought'; createdAt: number; value: Thought }\n  | { kind: 'toolCall'; createdAt: number; value: ToolCall }\n\n/**\n * Assembles the complete OpenAI Chat Completions message history for a dispatch — system prompt and\n * content buckets, the interleaved timeline of messages/thoughts/tool calls (with synthetic\n * `assistant.tool_calls` and `tool.tool_call_id` shaping), and the collected opaque reasoning\n * payloads — by delegating to the injected sub-renderers.\n */\nexport const buildChatCompletionsHistory = async (input: {\n  systemPrompt: Tokenizable\n  standingInstructions: Iterable<Tokenizable>\n  memories: Iterable<Memory>\n  retrievables: Iterable<Retrievable>\n  messages: Iterable<Message>\n  thoughts: Iterable<Thought>\n  toolCalls: Iterable<ToolCall>\n  tools: ToolRegistry\n  renderedToolCallResults: Map<string, string | ChatCompletionsContentBlock[]>\n  bucketOrder: ChatCompletionsBucketOrder\n  selfIdentity: string\n  thoughtSurfacing: 'all-self' | 'latest-self' | 'all'\n  replayCompatibility: ReadonlyArray<string>\n  unsupportedMediaPolicy: UnsupportedMediaPolicy\n  renderChatCompletionsToolCallResult: ChatCompletionsHelpers['renderChatCompletionsToolCallResult']\n  renderChatCompletionsSystemPrompt: ChatHelpersCommon['renderChatCompletionsSystemPrompt']\n  renderStandingInstructions: ChatHelpersCommon['renderStandingInstructions']\n  renderMemories: ChatHelpersCommon['renderMemories']\n  renderRetrievables: ChatHelpersCommon['renderRetrievables']\n  renderRetrievableSafetyDirective: ChatHelpersCommon['renderRetrievableSafetyDirective']\n  renderFirstPartyRetrievables: ChatHelpersCommon['renderFirstPartyRetrievables']\n  renderThirdPartyPublicRetrievables: ChatHelpersCommon['renderThirdPartyPublicRetrievables']\n  renderThirdPartyPrivateRetrievables: ChatHelpersCommon['renderThirdPartyPrivateRetrievables']\n  renderTimelineMessage: ChatCompletionsHelpers['renderTimelineMessage']\n  renderThought: ChatHelpersCommon['renderThought']\n  filterThoughts: ChatHelpersCommon['filterThoughts']\n  renderUntrustedContent: ChatHelpersCommon['renderUntrustedContent']\n  renderTrustedContent: ChatHelpersCommon['renderTrustedContent']\n  warn?: (msg: string) => void\n}): Promise<{\n  messages: ChatCompletionsMessage[]\n  reasoningPayloads: Array<{ id: string; replayCompatibility: string; payload: unknown }>\n}> => {\n  const out: ChatCompletionsMessage[] = []\n  const reasoningPayloads: Array<{\n    id: string\n    replayCompatibility: string\n    payload: unknown\n  }> = []\n\n  const buckets = input.bucketOrder\n  const timelineIdx = buckets.indexOf('timeline')\n\n  // Build leading system content from base prompt + before-timeline buckets.\n  const leadingSystem = await input.renderChatCompletionsSystemPrompt({\n    systemPrompt: input.systemPrompt,\n    standingInstructions: input.standingInstructions,\n    memories: input.memories,\n    retrievables: input.retrievables,\n    bucketOrder: buckets,\n    renderStandingInstructions: input.renderStandingInstructions,\n    renderMemories: input.renderMemories,\n    renderRetrievables: input.renderRetrievables,\n    renderRetrievableSafetyDirective: input.renderRetrievableSafetyDirective,\n    renderFirstPartyRetrievables: input.renderFirstPartyRetrievables,\n    renderThirdPartyPublicRetrievables: input.renderThirdPartyPublicRetrievables,\n    renderThirdPartyPrivateRetrievables: input.renderThirdPartyPrivateRetrievables,\n    renderUntrustedContent: input.renderUntrustedContent,\n  })\n  if (leadingSystem.length > 0) {\n    out.push({ role: 'system', content: leadingSystem })\n  }\n\n  // Build the timeline (if present in bucketOrder).\n  const includesTimeline = timelineIdx !== -1\n  if (includesTimeline) {\n    // Filter thoughts per surfacing mode + compatibility.\n    const survivingThoughts = input.filterThoughts(\n      input.thoughts,\n      input.thoughtSurfacing,\n      input.selfIdentity,\n      input.replayCompatibility\n    )\n\n    // Build sorted timeline items.\n    const items: TimelineItem[] = []\n    for (const m of input.messages) {\n      items.push({ kind: 'message', createdAt: m.createdAt.toMillis(), value: m })\n    }\n    for (const t of survivingThoughts) {\n      items.push({ kind: 'thought', createdAt: t.createdAt.toMillis(), value: t })\n    }\n    for (const tc of input.toolCalls) {\n      items.push({ kind: 'toolCall', createdAt: tc.createdAt.toMillis(), value: tc })\n    }\n    items.sort((a, b) => a.createdAt - b.createdAt)\n\n    const replaySet = new Set<string>([...input.replayCompatibility])\n\n    for (const item of items) {\n      if (item.kind === 'message') {\n        out.push(\n          await input.renderTimelineMessage({\n            message: item.value,\n            selfIdentity: input.selfIdentity,\n            unsupportedMediaPolicy: input.unsupportedMediaPolicy,\n            warn: input.warn,\n          })\n        )\n      } else if (item.kind === 'thought') {\n        const t = item.value\n        const identifier = String(t.identity?.identifier ?? '')\n        const isSelf = identifier === input.selfIdentity\n        const hasPayload = t.payload !== undefined\n        const compatTag = t.replayCompatibility\n\n        if (hasPayload && compatTag && replaySet.has(compatTag)) {\n          // Opaque reasoning — side-channel + summary envelope.\n          reasoningPayloads.push({\n            id: t.id,\n            replayCompatibility: compatTag,\n            payload: t.payload,\n          })\n          const envelope = input.renderThought(\n            t.content.toString(),\n            {\n              nonce: t.id,\n              kind: 'opaque-reasoning',\n              from: identifier,\n              createdAt: t.createdAt?.toISO?.() ?? undefined,\n              replayCompatibility: compatTag,\n            },\n            t.payload\n          )\n          const synthetic: ChatCompletionsMessage = {\n            role: 'assistant',\n            content: envelope,\n          }\n          if (!isSelf && identifier.length > 0) {\n            synthetic.name = sanitiseNameField(identifier)\n          }\n          out.push(synthetic)\n        } else if (!hasPayload) {\n          // Plain-text reasoning (no payload, or tagged plain-text, or tagged but matched).\n          const envelope = input.renderThought(t.content.toString(), {\n            nonce: t.id,\n            kind: isSelf ? 'self-reasoning' : 'peer-reasoning',\n            from: identifier,\n            createdAt: t.createdAt?.toISO?.() ?? undefined,\n          })\n          const synthetic: ChatCompletionsMessage = {\n            role: 'assistant',\n            content: envelope,\n          }\n          if (!isSelf && identifier.length > 0) {\n            synthetic.name = sanitiseNameField(identifier)\n          }\n          out.push(synthetic)\n        }\n        // else: opaque, non-matching → elided (NOT removed from ctx.turnThoughts upstream).\n      } else {\n        // tool call: emit a synthetic assistant message carrying tool_calls[],\n        // followed by a tool-role message with the result.\n        const tc = item.value\n        const assistantMsg: ChatCompletionsMessage = {\n          role: 'assistant',\n          content: null,\n          tool_calls: [\n            {\n              id: tc.id,\n              type: 'function',\n              function: {\n                name: tc.tool,\n                arguments: typeof tc.args === 'string' ? tc.args : JSON.stringify(tc.args ?? {}),\n              },\n            },\n          ],\n        }\n        out.push(assistantMsg)\n\n        let rendered = input.renderedToolCallResults.get(tc.id)\n        if (rendered === undefined) {\n          const tool = input.tools.get?.(tc.tool)\n          rendered = await input.renderChatCompletionsToolCallResult({\n            toolCall: tc,\n            results: tc.results as\n              | Tokenizable\n              | SpooledArtifact\n              | SpooledArtifact[]\n              | Media\n              | Media[],\n            tool: tool as Tool | ArtifactTool | undefined,\n            renderUntrustedContent: input.renderUntrustedContent,\n            renderTrustedContent: input.renderTrustedContent,\n            unsupportedMediaPolicy: input.unsupportedMediaPolicy,\n            warn: input.warn,\n          })\n        }\n        out.push({\n          role: 'tool',\n          content: rendered,\n          tool_call_id: tc.id,\n        })\n      }\n    }\n  }\n\n  // Trailing system message for after-timeline buckets.\n  if (includesTimeline) {\n    const trailingParts: string[] = []\n    for (let i = timelineIdx + 1; i < buckets.length; i++) {\n      const label = buckets[i]!\n      if (label === 'standingInstructions') {\n        const block = input.renderStandingInstructions(input.standingInstructions)\n        if (block.length > 0) trailingParts.push(block)\n      } else if (label === 'memories') {\n        const wrapped: Array<{ memory: Memory; attrs: MemoryAttrs }> = []\n        for (const m of input.memories) {\n          wrapped.push(memoryToAttrs(m))\n        }\n        const block = input.renderMemories(wrapped)\n        if (block.length > 0) trailingParts.push(block)\n      } else if (label === 'retrievables') {\n        const wrapped: Array<{ retrievable: Retrievable; attrs: RetrievableAttrs }> = []\n        for (const r of input.retrievables) {\n          wrapped.push(retrievableToAttrs(r))\n        }\n        const block = await input.renderRetrievables(wrapped, {\n          renderRetrievableSafetyDirective: input.renderRetrievableSafetyDirective,\n          renderFirstPartyRetrievables: input.renderFirstPartyRetrievables,\n          renderThirdPartyPublicRetrievables: input.renderThirdPartyPublicRetrievables,\n          renderThirdPartyPrivateRetrievables: input.renderThirdPartyPrivateRetrievables,\n          renderUntrustedContent: input.renderUntrustedContent,\n        })\n        if (block.length > 0) trailingParts.push(block)\n      }\n    }\n    if (trailingParts.length > 0) {\n      out.push({ role: 'system', content: trailingParts.join('\\n\\n') })\n    }\n  }\n\n  return { messages: out, reasoningPayloads }\n}\n/** Default history assembler; alias of {@link buildChatCompletionsHistory}. */\nexport const defaultBuildChatCompletionsHistory = buildChatCompletionsHistory\n\n// ─── createChatCompletionsToolCallDeltaAccumulator ────────────────────────────\n\n/**\n * Creates a fresh accumulator that stitches streamed {@link ChatCompletionsToolCallDelta} fragments\n * (keyed by their stream index) into fully-assembled tool calls, drained once the stream completes.\n */\nexport const createChatCompletionsToolCallDeltaAccumulator =\n  (): ChatCompletionsToolCallDeltaAccumulator => {\n    const byIndex = new Map<\n      number,\n      { id?: string; type?: 'function'; name: string; args: string }\n    >()\n    return {\n      feed(delta: ChatCompletionsToolCallDelta): void {\n        const idx = delta.index\n        let entry = byIndex.get(idx)\n        if (!entry) {\n          entry = { name: '', args: '' }\n          byIndex.set(idx, entry)\n        }\n        if (delta.id !== undefined) entry.id = delta.id\n        if (delta.type !== undefined) entry.type = delta.type\n        if (delta.function?.name !== undefined) {\n          entry.name = entry.name + delta.function.name\n        }\n        if (delta.function?.arguments !== undefined) {\n          entry.args = entry.args + delta.function.arguments\n        }\n      },\n      drain(): AssembledToolCall[] {\n        const out: AssembledToolCall[] = []\n        const indices = Array.from(byIndex.keys()).sort((a, b) => a - b)\n        for (const idx of indices) {\n          const e = byIndex.get(idx)!\n          out.push({\n            id: e.id ?? `call_${idx}`,\n            type: e.type ?? 'function',\n            name: e.name,\n            args: e.args,\n          })\n        }\n        return out\n      },\n    }\n  }\n/** Default delta-accumulator factory; alias of {@link createChatCompletionsToolCallDeltaAccumulator}. */\nexport const defaultCreateChatCompletionsToolCallDeltaAccumulator =\n  createChatCompletionsToolCallDeltaAccumulator\n"],"mappings":"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"}