@nhtio/adk 0.1.0-master-e04b0eba → 0.1.0-master-d3e80e7a

package/batteries/llm/webllm_chat_completions/adapter.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.cjs","names":["#baseline","#engine","#resolveEngine","#enginePromise"],"sources":["../../../../src/batteries/llm/webllm_chat_completions/adapter.ts"],"sourcesContent":["/**\n * Cross-environment executor adapter for WebLLM Chat Completions compatible endpoints.\n *\n * @module @nhtio/adk/batteries/llm/webllm_chat_completions/adapter\n *\n * @remarks\n * Cross-environment LLM adapter for the WebLLM Chat Completions wire shape. Chat Completions was\n * chosen as the ADK's reference adapter because it is the de-facto interchange format for the\n * majority of OpenAI-compatible gateways (vLLM, Together, Groq, Fireworks, Ollama, Azure OpenAI,\n * OpenRouter, DeepSeek, Mistral La Plateforme, and most self-hosted deployments). Its tool-call\n * synthetic-history shape (`role: 'assistant', tool_calls: [...]` followed by `role: 'tool'` with\n * `tool_call_id`) is the lowest-common-denominator that every conformant gateway accepts.\n *\n * The adapter is built around three pluggable layers:\n *\n * 1. **Translation helpers** — the thirteen swappable functions exported from `./helpers` turn\n *    ADK primitives ({@link @nhtio/adk!Tokenizable}, {@link @nhtio/adk!Memory}, {@link @nhtio/adk!Message}, {@link @nhtio/adk!Thought},\n *    {@link @nhtio/adk!ToolCall}, {@link @nhtio/adk!Tool}, {@link @nhtio/adk!ArtifactTool}, {@link @nhtio/adk!SpooledArtifact}) into Chat\n *    Completions wire shapes. Consumers override individual helpers via `options.helpers.*` to\n *    customise envelope formats, bucket ordering, thought surfacing, or JSON Schema generation\n *    without forking the adapter.\n * 2. **Three-layer options merging** — constructor baseline, per-`executor()` overrides, and\n *    per-iteration `ctx.stash.webLLMChatCompletions` overrides combine with key-by-key\n *    precedence for `helpers` and wholesale replacement for everything else.\n *    The merged shape is re-validated on every iteration so a malformed stash override\n *    fails loud, not silently.\n * 3. **WebLLM engine invocation** — accepts a preloaded `engine` or lazy `createEngine` factory.\n *    The resolved request body is passed directly to WebLLM's OpenAI-compatible chat API.\n *\n * Per-iteration flow (steps 1–9 of the plan):\n * 1. Merge constructor / executor / stash options and re-validate.\n * 2. Resolve helpers, falling back to bundled `default*` for each unset field.\n * 3. Forge artifact-query tools by walking `ctx.turnToolCalls`, collecting unique\n *    `SpooledArtifact` constructors, calling `<Ctor>.forgeTools(ctx)` on each, and merging the\n *    results with `ctx.tools`.\n * 4. Pre-render every persisted tool-call result into the prompt-ready string the timeline will\n *    use, cached by `tc.id`.\n * 5. When `tokenEncoding !== null`, sum the token weight of every persisted bucket and throw\n *    {@link @nhtio/adk/batteries!E_WEBLLM_CHAT_COMPLETIONS_CONTEXT_OVERFLOW} when the total exceeds `contextWindow`.\n * 6. Build the request body via `buildChatCompletionsHistory`; carry vendor-opaque reasoning\n *    blocks through the `_adk_reasoning_payloads` side-channel.\n * 7. Resolve or lazily create a WebLLM engine and call `engine.chat.completions.create(body)`.\n * 8. Streaming path: consume WebLLM's async chunk iterable; surface deltas through\n *    `helpers.reportMessage` / `reportThought` / `reportToolCall`; assemble tool-call deltas via\n *    the accumulator; persist `Message` / `Thought` / `ToolCall` records on stream end.\n * 9. Non-streaming path: consume the returned Chat Completion object; same persistence +\n *    tool-execution loop.\n */\n\nimport { DateTime } from 'luxon'\nimport { sha256 } from 'js-sha256'\nimport { v6 as uuidv6 } from 'uuid'\nimport { validateOptions } from './validation'\nimport { isError, isInstanceOf, isObject } from '@nhtio/adk/guards'\nimport { canonicalStringify } from '../../../lib/utils/canonical_json'\nimport { InMemorySpoolStore } from '@nhtio/adk/batteries/storage/in_memory'\nimport {\n  Tokenizable,\n  ToolRegistry,\n  ToolCall,\n  Message,\n  Thought,\n  SpooledArtifact,\n  Media,\n  ArtifactTool,\n} from '@nhtio/adk/common'\nimport {\n  E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS,\n  E_WEBLLM_CHAT_COMPLETIONS_CONTEXT_OVERFLOW,\n  E_WEBLLM_CHAT_COMPLETIONS_STREAM_ERROR,\n  E_WEBLLM_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS,\n} from './exceptions'\nimport {\n  defaultDescriptionToChatCompletionsJsonSchema,\n  defaultRenderUntrustedContent,\n  defaultRenderTrustedContent,\n  defaultRenderStandingInstructions,\n  defaultRenderMemories,\n  defaultRenderRetrievables,\n  defaultRenderRetrievableSafetyDirective,\n  defaultRenderFirstPartyRetrievables,\n  defaultRenderThirdPartyPublicRetrievables,\n  defaultRenderThirdPartyPrivateRetrievables,\n  defaultRenderTimelineMessage,\n  defaultRenderThought,\n  defaultFilterThoughts,\n  defaultToolsToChatCompletionsTools,\n  defaultRenderChatCompletionsSystemPrompt,\n  defaultRenderChatCompletionsToolCallResult,\n  defaultBuildChatCompletionsHistory,\n  defaultCreateChatCompletionsToolCallDeltaAccumulator,\n} from './helpers'\nimport type { DispatchContext } from '@nhtio/adk/types'\nimport type { Tool, Memory, TokenEncoding } from '@nhtio/adk/common'\nimport type { DispatchExecutorFn, DispatchExecutorHelpers } from '@nhtio/adk/dispatch_runner'\nimport type {\n  WebLLMChatCompletionsAdapterOptions,\n  ChatCompletionsHelpers,\n  WebLLMChatCompletionsRequestBody,\n  ChatCompletionsChunk,\n  ChatCompletionsResponse,\n  AssembledToolCall,\n  ChatCompletionsContentBlock,\n  WebLLMEngine,\n} from './types'\n\n// ─── ADK-control keys (stripped before sending the request body) ──────────\n\nconst ADK_CONTROL_KEYS: ReadonlySet<string> = new Set([\n  'engine',\n  'createEngine',\n  'engineConfig',\n  'chatOptions',\n  'stream',\n  'bucketOrder',\n  'contextWindow',\n  'selfIdentity',\n  'thoughtSurfacing',\n  'tokenEncoding',\n  'replayCompatibility',\n  'helpers',\n  'strictToolChoice',\n  'unsupportedMediaPolicy',\n  'onInitProgress',\n  'isWebGPUAvailable',\n  'autoAck',\n])\n\n// ─── Option merging ───────────────────────────────────────────────────────────\n\nconst mergeHelpers = (\n  layers: ReadonlyArray<Partial<ChatCompletionsHelpers> | undefined>\n): Partial<ChatCompletionsHelpers> | undefined => {\n  let merged: Partial<ChatCompletionsHelpers> | undefined\n  for (const layer of layers) {\n    if (!layer) continue\n    merged = { ...(merged ?? {}), ...layer }\n  }\n  return merged\n}\n\nconst mergeOptions = (\n  baseline: WebLLMChatCompletionsAdapterOptions,\n  exec: Partial<WebLLMChatCompletionsAdapterOptions> | undefined,\n  stash: Partial<WebLLMChatCompletionsAdapterOptions> | undefined\n): Partial<WebLLMChatCompletionsAdapterOptions> => {\n  const layers = [baseline as Partial<WebLLMChatCompletionsAdapterOptions>, exec ?? {}, stash ?? {}]\n  const out: Record<string, unknown> = {}\n  for (const layer of layers) {\n    for (const [k, v] of Object.entries(layer)) {\n      if (v === undefined) continue\n      if (k === 'helpers') continue\n      out[k] = v\n    }\n  }\n  const helpers = mergeHelpers(layers.map((l) => l.helpers))\n  if (helpers !== undefined) out.helpers = helpers\n  return out as Partial<WebLLMChatCompletionsAdapterOptions>\n}\n\n// ─── Helper resolution ────────────────────────────────────────────────────────\n\nconst resolveHelpers = (\n  overrides: Partial<ChatCompletionsHelpers> | undefined\n): ChatCompletionsHelpers => {\n  const src = overrides ?? {}\n  return {\n    descriptionToChatCompletionsJsonSchema:\n      src.descriptionToChatCompletionsJsonSchema ?? defaultDescriptionToChatCompletionsJsonSchema,\n    renderUntrustedContent: src.renderUntrustedContent ?? defaultRenderUntrustedContent,\n    renderTrustedContent: src.renderTrustedContent ?? defaultRenderTrustedContent,\n    renderStandingInstructions: src.renderStandingInstructions ?? defaultRenderStandingInstructions,\n    renderMemories: src.renderMemories ?? defaultRenderMemories,\n    renderRetrievables: src.renderRetrievables ?? defaultRenderRetrievables,\n    renderRetrievableSafetyDirective:\n      src.renderRetrievableSafetyDirective ?? defaultRenderRetrievableSafetyDirective,\n    renderFirstPartyRetrievables:\n      src.renderFirstPartyRetrievables ?? defaultRenderFirstPartyRetrievables,\n    renderThirdPartyPublicRetrievables:\n      src.renderThirdPartyPublicRetrievables ?? defaultRenderThirdPartyPublicRetrievables,\n    renderThirdPartyPrivateRetrievables:\n      src.renderThirdPartyPrivateRetrievables ?? defaultRenderThirdPartyPrivateRetrievables,\n    renderTimelineMessage: src.renderTimelineMessage ?? defaultRenderTimelineMessage,\n    renderThought: src.renderThought ?? defaultRenderThought,\n    filterThoughts: src.filterThoughts ?? defaultFilterThoughts,\n    toolsToChatCompletionsTools:\n      src.toolsToChatCompletionsTools ?? defaultToolsToChatCompletionsTools,\n    renderChatCompletionsSystemPrompt:\n      src.renderChatCompletionsSystemPrompt ?? defaultRenderChatCompletionsSystemPrompt,\n    renderChatCompletionsToolCallResult:\n      src.renderChatCompletionsToolCallResult ?? defaultRenderChatCompletionsToolCallResult,\n    buildChatCompletionsHistory:\n      src.buildChatCompletionsHistory ?? defaultBuildChatCompletionsHistory,\n    createChatCompletionsToolCallDeltaAccumulator:\n      src.createChatCompletionsToolCallDeltaAccumulator ??\n      defaultCreateChatCompletionsToolCallDeltaAccumulator,\n  }\n}\n\n// ─── ID helpers ───────────────────────────────────────────────────────────────\n\n// Canonical (key-order-insensitive) checksum — MUST match the contract documented\n// on canonicalStringify and used by Tool.executor + dispatch_runner's streaming\n// helper, so ctx.toolCallCount(checksum) detects semantically-identical repeat\n// calls regardless of argument key order.\nconst computeChecksum = (tool: string, args: unknown): string =>\n  sha256(canonicalStringify({ tool, args }))\n\nconst nowIso = (): string => DateTime.now().toISO() ?? new Date().toISOString()\n\n// ─── Token measurement ────────────────────────────────────────────────────────\n\nconst estimateTokensOf = async (\n  value: { estimateTokens: (encoding: TokenEncoding) => number | Promise<number> },\n  encoding: TokenEncoding\n): Promise<number> => {\n  return Promise.resolve(value.estimateTokens(encoding))\n}\n\n// ─── Adapter class ────────────────────────────────────────────────────────────\n\n/**\n * Opinionated cross-environment LLM adapter for the WebLLM Chat Completions wire shape.\n *\n * @remarks\n * Construction validates options eagerly via {@link @nhtio/adk/batteries!validateOptions} and throws\n * {@link @nhtio/adk/batteries!E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS} on failure — config bugs fail loud, not at\n * dispatch time. The returned instance is reusable: call {@link WebLLMChatCompletionsAdapter.executor}\n * once per `DispatchRunner` configuration to obtain an {@link @nhtio/adk!DispatchExecutorFn} bound to the\n * baseline plus optional executor-scope overrides.\n *\n * Per-iteration overrides live on the active {@link @nhtio/adk!DispatchContext}'s\n * `stash.webLLMChatCompletions` slot and take highest precedence — they merge into the\n * executor-scope shape on every iteration. `helpers` merge key-by-key across all three layers;\n * every other field is replaced wholesale at the highest layer that\n * sets it.\n */\nexport class WebLLMChatCompletionsAdapter {\n  /**\n   * Customary key for per-iteration overrides on `ctx.stash`. The adapter reads\n   * `ctx.stash.get(WebLLMChatCompletionsAdapter.STASH_KEY, {})` at the start of every\n   * iteration and merges the value into the resolved options shape.\n   */\n  public static readonly STASH_KEY = 'webLLMChatCompletions' as const\n\n  readonly #baseline: WebLLMChatCompletionsAdapterOptions\n  #engine: WebLLMEngine | undefined\n  #enginePromise: Promise<WebLLMEngine> | undefined\n\n  public static isAvailable(): boolean {\n    return (\n      typeof globalThis.navigator !== 'undefined' &&\n      'gpu' in globalThis.navigator &&\n      typeof (globalThis.navigator as { gpu?: unknown }).gpu !== 'undefined'\n    )\n  }\n\n  /**\n   * @param options - Constructor-baseline options. Re-validated on every iteration after\n   *   per-dispatch and per-iteration overrides are layered in.\n   * @throws {@link @nhtio/adk/batteries!E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS} when `options` does not satisfy\n   *   {@link @nhtio/adk/batteries!webLLMChatCompletionsOptionsSchema}.\n   */\n  constructor(options: unknown) {\n    this.#baseline = validateOptions(options)\n    this.#engine = this.#baseline.engine\n  }\n\n  async preload(overrides?: Partial<WebLLMChatCompletionsAdapterOptions>): Promise<WebLLMEngine> {\n    const merged = validateOptions(mergeOptions(this.#baseline, overrides, undefined))\n    return this.#resolveEngine(merged)\n  }\n\n  reset(): void {\n    this.#engine = undefined\n    this.#enginePromise = undefined\n  }\n\n  isAvailable(): boolean {\n    return (this.#baseline.isWebGPUAvailable ?? WebLLMChatCompletionsAdapter.isAvailable)()\n  }\n\n  async #resolveEngine(merged: WebLLMChatCompletionsAdapterOptions): Promise<WebLLMEngine> {\n    if (merged.engine) {\n      this.#engine = merged.engine\n      return merged.engine\n    }\n    if (this.#engine) return this.#engine\n    const available = (merged.isWebGPUAvailable ?? WebLLMChatCompletionsAdapter.isAvailable)()\n    if (!available) {\n      throw new E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS([\n        'WebLLM requires a browser/runtime with WebGPU support',\n      ])\n    }\n    this.#enginePromise ??= (async () => {\n      const createEngine =\n        merged.createEngine ??\n        (async ({ model, engineConfig, chatOptions, onInitProgress }) => {\n          const { CreateMLCEngine } = await import('@mlc-ai/web-llm')\n          return (await CreateMLCEngine(\n            model,\n            { ...(engineConfig ?? {}), initProgressCallback: onInitProgress },\n            chatOptions\n          )) as WebLLMEngine\n        })\n      const engine = await createEngine({\n        model: merged.model,\n        engineConfig: merged.engineConfig,\n        chatOptions: merged.chatOptions,\n        onInitProgress: merged.onInitProgress,\n      })\n      this.#engine = engine\n      return engine\n    })()\n    return this.#enginePromise\n  }\n\n  /**\n   * Returns an {@link @nhtio/adk!DispatchExecutorFn} bound to this adapter's baseline plus optional\n   * executor-scope overrides. The returned function is reusable across iterations — every\n   * iteration re-merges with `ctx.stash[STASH_KEY]` and re-validates the result.\n   *\n   * @param overrides - Optional executor-scope overrides. Higher precedence than the baseline,\n   *   lower precedence than `ctx.stash[STASH_KEY]`.\n   * @returns An {@link @nhtio/adk!DispatchExecutorFn} suitable for `DispatchRunner`.\n   */\n  executor(overrides?: Partial<WebLLMChatCompletionsAdapterOptions>): DispatchExecutorFn {\n    const baseline = this.#baseline\n    const adapterClass = WebLLMChatCompletionsAdapter\n    return async (ctx: DispatchContext, helpers: DispatchExecutorHelpers): Promise<void> => {\n      // Bridge helpers.log → the legacy `warn: (msg) => void` slot exposed by the per-call\n      // helper signatures. Helpers downstream don't need to know the structured shape — they\n      // emit a single string, which we route to `helpers.log.warn` with a stable `kind` so\n      // observability middleware can still filter and aggregate.\n      const localWarn = (msg: string): void => {\n        helpers.log.warn({ kind: 'helper-warning', message: msg })\n      }\n\n      // ── Step 1: merge & validate ──────────────────────────────────────────\n      const stashRaw = ctx.stash.get(adapterClass.STASH_KEY, {}) as unknown\n      const stashOverrides =\n        stashRaw && typeof stashRaw === 'object'\n          ? (stashRaw as Partial<WebLLMChatCompletionsAdapterOptions>)\n          : {}\n      const mergedRaw = mergeOptions(baseline, overrides, stashOverrides)\n      const merged = validateOptions(mergedRaw)\n\n      // Cross-field invariant: tokenEncoding non-null requires contextWindow.\n      if (merged.tokenEncoding !== null && merged.contextWindow === undefined) {\n        throw new E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS([\n          'tokenEncoding is non-null but contextWindow is undefined',\n        ])\n      }\n\n      // ── Step 2: resolve helpers ───────────────────────────────────────────\n      const resolvedHelpers = resolveHelpers(merged.helpers)\n\n      // ── Step 3: forge artifact-query tools ────────────────────────────────\n      const uniqueCtors = new Set<typeof SpooledArtifact>()\n      for (const tc of ctx.turnToolCalls) {\n        const results = tc.results as unknown as { constructor?: unknown }\n        const ctor = results?.constructor\n        if (ctor && SpooledArtifact.isSpooledArtifactConstructor(ctor)) {\n          uniqueCtors.add(ctor as unknown as typeof SpooledArtifact)\n        }\n      }\n      const forgedRegistries: ToolRegistry[] = []\n      for (const ctor of uniqueCtors) {\n        const forgeFn = (\n          ctor as unknown as {\n            forgeTools?: (c: DispatchContext) => ToolRegistry\n          }\n        ).forgeTools\n        if (typeof forgeFn === 'function') {\n          forgedRegistries.push(forgeFn.call(ctor, ctx))\n        }\n      }\n      const mergedRegistry = ToolRegistry.merge([ctx.tools, ...forgedRegistries], {\n        onCollision: 'replace',\n      })\n      mergedRegistry.bindContext(ctx)\n\n      // ── Step 4: pre-render tool-call results ──────────────────────────────\n      const renderedToolCallResults = new Map<string, string | ChatCompletionsContentBlock[]>()\n      for (const tc of ctx.turnToolCalls) {\n        const rendered = await resolvedHelpers.renderChatCompletionsToolCallResult({\n          toolCall: tc,\n          results: tc.results as\n            | Tokenizable\n            | SpooledArtifact\n            | SpooledArtifact[]\n            | Media\n            | Media[],\n          tool: mergedRegistry.get(tc.tool) as Tool | ArtifactTool | undefined,\n          renderUntrustedContent: resolvedHelpers.renderUntrustedContent,\n          renderTrustedContent: resolvedHelpers.renderTrustedContent,\n          unsupportedMediaPolicy: merged.unsupportedMediaPolicy ?? 'throw',\n          warn: localWarn,\n        })\n        renderedToolCallResults.set(tc.id, rendered)\n      }\n\n      // ── Step 5: context window enforcement ────────────────────────────────\n      if (merged.tokenEncoding !== null && merged.contextWindow !== undefined) {\n        const encoding = merged.tokenEncoding as TokenEncoding\n        let spTokens = await estimateTokensOf(ctx.systemPrompt, encoding)\n        let siTokens = 0\n        for (const si of ctx.standingInstructions) {\n          siTokens += await estimateTokensOf(si, encoding)\n        }\n        let memTokens = 0\n        for (const mem of ctx.turnMemories as Set<Memory>) {\n          memTokens += await estimateTokensOf(mem.content, encoding)\n        }\n        let retTokens = 0\n        for (const r of ctx.turnRetrievables) {\n          retTokens += await estimateTokensOf(r.content, encoding)\n        }\n        let tlTokens = 0\n        for (const msg of ctx.turnMessages) {\n          if (msg.content !== undefined) {\n            tlTokens += await estimateTokensOf(msg.content, encoding)\n          }\n        }\n        for (const th of ctx.turnThoughts) {\n          tlTokens += await estimateTokensOf(th.content, encoding)\n        }\n        for (const rendered of renderedToolCallResults.values()) {\n          const textPart =\n            typeof rendered === 'string'\n              ? rendered\n              : rendered\n                  .filter((b): b is { type: 'text'; text: string } => b.type === 'text')\n                  .map((b) => b.text)\n                  .join('\\n')\n          const tk = new Tokenizable(textPart)\n          tlTokens += await estimateTokensOf(tk, encoding)\n        }\n        const total = spTokens + siTokens + memTokens + retTokens + tlTokens\n        const perBucketObj = {\n          systemPrompt: spTokens,\n          standingInstructions: siTokens,\n          memories: memTokens,\n          retrievables: retTokens,\n          timeline: tlTokens,\n        }\n        helpers.log.debug({\n          kind: 'context-window-usage',\n          message: `Context window usage: ${total}/${merged.contextWindow} tokens`,\n          payload: {\n            total,\n            limit: merged.contextWindow,\n            encoding,\n            perBucket: perBucketObj,\n          },\n        })\n        if (total > merged.contextWindow) {\n          const perBucket = JSON.stringify(perBucketObj)\n          throw new E_WEBLLM_CHAT_COMPLETIONS_CONTEXT_OVERFLOW([\n            total,\n            merged.contextWindow,\n            encoding,\n            perBucket,\n          ])\n        }\n      }\n\n      // ── Step 5b: tool_choice + forged artifact-tools guard ────────────────\n      // When `tool_choice` (or the `allowed_tools` variant) forces the model onto a specific\n      // tool name and that name resolves to an ephemeral, forged artifact-query tool, surface\n      // it as a structured warning (or throw under `strictToolChoice: true`). Forging an\n      // artifact-query tool by name is almost always a misconfiguration — the tool may not\n      // exist in the next iteration once the artifact ages out of `ctx.turnToolCalls`.\n      const forcedToolNames: string[] = []\n      const toolChoice = merged.tool_choice\n      let toolChoiceVariant: 'function' | 'allowed_tools' = 'function'\n      if (toolChoice && typeof toolChoice === 'object') {\n        if ('function' in toolChoice && toolChoice.type === 'function') {\n          forcedToolNames.push(toolChoice.function.name)\n        } else if ('custom' in toolChoice && toolChoice.type === 'custom') {\n          forcedToolNames.push(toolChoice.custom.name)\n        } else if (toolChoice.type === 'allowed_tools') {\n          toolChoiceVariant = 'allowed_tools'\n          for (const entry of toolChoice.allowed_tools.tools) {\n            if ('function' in entry) forcedToolNames.push(entry.function.name)\n            else if ('custom' in entry) forcedToolNames.push(entry.custom.name)\n          }\n        }\n      }\n      const forcedForgedHits: Array<{ toolName: string }> = []\n      for (const name of forcedToolNames) {\n        const t = mergedRegistry.get(name) as { ephemeral?: boolean } | undefined\n        if (t?.ephemeral === true) {\n          forcedForgedHits.push({ toolName: name })\n        }\n      }\n      if (forcedForgedHits.length > 0) {\n        if (merged.strictToolChoice === true) {\n          throw new E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS([\n            `tool_choice forces forged ephemeral artifact-query tool(s): ${forcedForgedHits\n              .map((h) => h.toolName)\n              .join(\n                ', '\n              )} — these may not exist on the next iteration. Remove the override or unset strictToolChoice.`,\n          ])\n        }\n        helpers.log.warn({\n          kind: 'tool-choice-forged-artifact',\n          message: `tool_choice forces ${forcedForgedHits.length} forged ephemeral artifact-query tool(s); this is almost always a misconfiguration`,\n          payload: {\n            toolNames: forcedForgedHits.map((h) => h.toolName),\n            variant: toolChoiceVariant,\n          },\n        })\n      }\n\n      // ── Step 6: build request body ────────────────────────────────────────\n      const { messages: wireMessages, reasoningPayloads } =\n        await resolvedHelpers.buildChatCompletionsHistory({\n          systemPrompt: ctx.systemPrompt,\n          standingInstructions: ctx.standingInstructions,\n          memories: ctx.turnMemories,\n          retrievables: ctx.turnRetrievables,\n          messages: ctx.turnMessages,\n          thoughts: ctx.turnThoughts,\n          toolCalls: ctx.turnToolCalls,\n          tools: mergedRegistry,\n          renderedToolCallResults,\n          bucketOrder: merged.bucketOrder ?? [\n            'standingInstructions',\n            'memories',\n            'retrievables',\n            'timeline',\n          ],\n          selfIdentity: merged.selfIdentity ?? 'assistant',\n          thoughtSurfacing: merged.thoughtSurfacing ?? 'all-self',\n          replayCompatibility: merged.replayCompatibility ?? [],\n          renderChatCompletionsToolCallResult: resolvedHelpers.renderChatCompletionsToolCallResult,\n          renderChatCompletionsSystemPrompt: resolvedHelpers.renderChatCompletionsSystemPrompt,\n          renderStandingInstructions: resolvedHelpers.renderStandingInstructions,\n          renderMemories: resolvedHelpers.renderMemories,\n          renderRetrievables: resolvedHelpers.renderRetrievables,\n          renderRetrievableSafetyDirective: resolvedHelpers.renderRetrievableSafetyDirective,\n          renderFirstPartyRetrievables: resolvedHelpers.renderFirstPartyRetrievables,\n          renderThirdPartyPublicRetrievables: resolvedHelpers.renderThirdPartyPublicRetrievables,\n          renderThirdPartyPrivateRetrievables: resolvedHelpers.renderThirdPartyPrivateRetrievables,\n          renderTimelineMessage: resolvedHelpers.renderTimelineMessage,\n          renderThought: resolvedHelpers.renderThought,\n          filterThoughts: resolvedHelpers.filterThoughts,\n          renderUntrustedContent: resolvedHelpers.renderUntrustedContent,\n          renderTrustedContent: resolvedHelpers.renderTrustedContent,\n          unsupportedMediaPolicy: merged.unsupportedMediaPolicy ?? 'throw',\n          warn: localWarn,\n        })\n\n      const stream = merged.stream ?? true\n      const body: WebLLMChatCompletionsRequestBody = {\n        model: merged.model,\n        messages: wireMessages,\n        stream,\n      }\n      for (const [k, v] of Object.entries(merged)) {\n        if (ADK_CONTROL_KEYS.has(k)) continue\n        if (k === 'model' || k === 'messages' || k === 'stream') continue\n        if (v === undefined) continue\n        ;(body as Record<string, unknown>)[k] = v\n      }\n      const toolsArr = mergedRegistry.all()\n      if (toolsArr.length > 0) {\n        body.tools = resolvedHelpers.toolsToChatCompletionsTools(toolsArr, {\n          descriptionToChatCompletionsJsonSchema:\n            resolvedHelpers.descriptionToChatCompletionsJsonSchema,\n        })\n      }\n      if (reasoningPayloads.length > 0) {\n        body._adk_reasoning_payloads = reasoningPayloads\n      }\n\n      // ── Step 7: invoke WebLLM engine ─────────────────────────────────────\n      let completion: ChatCompletionsResponse | AsyncIterable<ChatCompletionsChunk>\n      try {\n        const engine = await this.#resolveEngine(merged)\n        completion = (await engine.chat.completions.create(body as never)) as\n          | ChatCompletionsResponse\n          | AsyncIterable<ChatCompletionsChunk>\n      } catch (err) {\n        helpers.log.error({\n          kind: 'webllm-engine-error',\n          message: `WebLLM engine failure: ${isError(err) ? err.message : String(err)}`,\n          payload: { detail: isError(err) ? err.message : String(err) },\n        })\n        ctx.nack(\n          new E_WEBLLM_CHAT_COMPLETIONS_STREAM_ERROR([isError(err) ? err.message : String(err)])\n        )\n        return\n      }\n\n      // Spool store used to back string / Uint8Array tool returns. Bytes are written under the\n      // call id; the resulting SpooledArtifact (or tool-configured subclass) is the model-visible\n      // handle for the rest of the turn. Injectable via the `spoolStore` option so consumers can\n      // back artifacts with durable storage (OPFS, Flydrive); defaults to an ephemeral per-dispatch\n      // in-memory store. NOTE: an injected durable store persists across turns, so call ids must be\n      // globally unique for that store (see the `spoolStore` option docs).\n      const spoolStore = merged.spoolStore ?? new InMemorySpoolStore()\n\n      // ── Inner helper: persist + execute one assembled tool call ───────────\n      const executeAndPersistToolCall = async (call: AssembledToolCall): Promise<void> => {\n        const tool = mergedRegistry.get(call.name)\n        // Parse args defensively. The model may emit non-JSON or a non-object\n        // JSON value (string, number, array, null); both are recoverable error\n        // conditions, NOT dispatch-killers. A parse failure short-circuits to\n        // a persisted error ToolCall — formatted by `E_WEBLLM_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS`\n        // so consumers can match on the stable error code — letting the model\n        // self-correct on the next iteration.\n        let args: Record<string, unknown> = {}\n        let parseError:\n          | InstanceType<typeof E_WEBLLM_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS>\n          | undefined\n        if (call.args && call.args.length > 0) {\n          try {\n            const parsed: unknown = JSON.parse(call.args)\n            if (isObject(parsed)) {\n              args = parsed\n            } else {\n              const receivedKind = Array.isArray(parsed)\n                ? 'array'\n                : parsed === null\n                  ? 'null'\n                  : typeof parsed\n              parseError = new E_WEBLLM_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS([\n                `must be a JSON object; received ${receivedKind}`,\n                call.args,\n              ])\n            }\n          } catch {\n            parseError = new E_WEBLLM_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS([\n              'are not valid JSON',\n              call.args,\n            ])\n          }\n        }\n        const completedAt = nowIso()\n        if (parseError !== undefined) {\n          const results = new Tokenizable(parseError.message)\n          helpers.reportToolCall(call.id, { tool: call.name, args })\n          helpers.reportToolCall(call.id, {\n            results,\n            isError: true,\n            isComplete: true,\n          })\n          const checksum = computeChecksum(call.name, args)\n          await ctx.storeToolCall(\n            new ToolCall({\n              id: call.id,\n              tool: call.name,\n              args,\n              checksum,\n              isComplete: true,\n              isError: true,\n              results,\n              createdAt: completedAt,\n              updatedAt: completedAt,\n              completedAt,\n            })\n          )\n          return\n        }\n        if (!tool) {\n          const errText = `Tool not found: ${call.name}`\n          const results = new Tokenizable(errText)\n          helpers.reportToolCall(call.id, { tool: call.name, args })\n          helpers.reportToolCall(call.id, {\n            results,\n            isError: true,\n            isComplete: true,\n          })\n          const checksum = computeChecksum(call.name, args)\n          await ctx.storeToolCall(\n            new ToolCall({\n              id: call.id,\n              tool: call.name,\n              args,\n              checksum,\n              isComplete: true,\n              isError: true,\n              results,\n              createdAt: completedAt,\n              updatedAt: completedAt,\n              completedAt,\n            })\n          )\n          return\n        }\n        helpers.reportToolCall(call.id, { tool: tool.name, args })\n        const isArtifactTool = ArtifactTool.isArtifactTool(tool)\n        let results: Tokenizable | SpooledArtifact | SpooledArtifact[] | Media | Media[] =\n          new Tokenizable('')\n        let toolHadError = false\n        try {\n          const raw = await tool.executor(ctx)(args)\n          if (isArtifactTool) {\n            // ArtifactTool: handler returns a string | Tokenizable that *is* the model-visible\n            // answer to a query against a prior artifact. No spool write, no SpooledArtifact\n            // construction — pass through (or wrap a bare string in Tokenizable).\n            if (Tokenizable.isTokenizable(raw)) {\n              results = raw\n            } else if (typeof raw === 'string') {\n              results = new Tokenizable(raw)\n            } else {\n              throw new Error(\n                `ArtifactTool \"${tool.name}\" returned a non-string/non-Tokenizable value`\n              )\n            }\n          } else if (Media.isMedia(raw)) {\n            results = raw\n          } else if (Array.isArray(raw) && raw.length > 0 && raw.every((m) => Media.isMedia(m))) {\n            results = raw as Media[]\n          } else if (typeof raw === 'string' || isInstanceOf(raw, 'Uint8Array', Uint8Array)) {\n            const reader = await spoolStore.write(call.id, raw as string | Uint8Array)\n            const ArtifactCtor = (tool as Tool).artifactConstructor?.() ?? SpooledArtifact\n            results = new ArtifactCtor(reader)\n          } else {\n            // Defensive fallback — wrap stringified value so the model gets *something*.\n            const reader = await spoolStore.write(call.id, String(raw))\n            const ArtifactCtor = (tool as Tool).artifactConstructor?.() ?? SpooledArtifact\n            results = new ArtifactCtor(reader)\n          }\n        } catch (err) {\n          toolHadError = true\n          // Surface field-level validation detail from the cause chain so the\n          // model can self-correct on the specific offending field. `E_INVALID_TOOL_ARGS`\n          // carries the joi `ValidationException` on `cause`, whose message is the\n          // joined field-level error text (e.g. `\"text\" is required`).\n          let detailMsg = isError(err) ? err.message : String(err)\n          if (\n            isError(err) &&\n            isError(err.cause) &&\n            err.cause.message &&\n            err.cause.message !== err.message\n          ) {\n            detailMsg = `${detailMsg} ${err.cause.message}`\n          }\n          results = new Tokenizable(detailMsg)\n        }\n        helpers.reportToolCall(call.id, {\n          results,\n          isError: toolHadError,\n          isComplete: true,\n        })\n        const checksum = computeChecksum(tool.name, args)\n        const completedAt2 = nowIso()\n        await ctx.storeToolCall(\n          new ToolCall({\n            id: call.id,\n            tool: tool.name,\n            args,\n            checksum,\n            isComplete: true,\n            isError: toolHadError,\n            results,\n            fromArtifactTool: isArtifactTool,\n            createdAt: completedAt2,\n            updatedAt: completedAt2,\n            completedAt: completedAt2,\n          })\n        )\n      }\n\n      const selfIdentity = merged.selfIdentity ?? 'assistant'\n\n      // ── Step 8: streaming path ────────────────────────────────────────────\n      if (stream) {\n        const chunks = completion as AsyncIterable<ChatCompletionsChunk>\n        if (!chunks || typeof chunks[Symbol.asyncIterator] !== 'function') {\n          ctx.nack(new E_WEBLLM_CHAT_COMPLETIONS_STREAM_ERROR(['engine did not return a stream']))\n          return\n        }\n        const accumulator = resolvedHelpers.createChatCompletionsToolCallDeltaAccumulator()\n        const streamId = uuidv6()\n\n        let partialMessageContent = ''\n        let partialThoughtContent = ''\n        let sawMessageDelta = false\n        let sawThoughtDelta = false\n\n        const drainAndPersist = async (): Promise<void> => {\n          if (sawMessageDelta) {\n            helpers.reportMessage(streamId, '', { isComplete: true })\n            await ctx.storeMessage(\n              new Message({\n                id: streamId,\n                role: 'assistant',\n                content: partialMessageContent,\n                identity: selfIdentity,\n                createdAt: nowIso(),\n                updatedAt: nowIso(),\n              })\n            )\n          }\n          if (sawThoughtDelta) {\n            helpers.reportThought(streamId, '', { isComplete: true })\n            await ctx.storeThought(\n              new Thought({\n                id: streamId,\n                content: partialThoughtContent,\n                identity: selfIdentity,\n                createdAt: nowIso(),\n                updatedAt: nowIso(),\n              })\n            )\n          }\n          const calls = accumulator.drain()\n          helpers.log.debug({\n            kind: 'accumulator-finalised',\n            message: `Stream finalised: ${calls.length} tool call(s), message=${sawMessageDelta}, thought=${sawThoughtDelta}`,\n            payload: { toolCallCount: calls.length, sawMessageDelta, sawThoughtDelta },\n          })\n          if (calls.length === 0) {\n            // No tool calls — terminal text answer. Self-ack only when opted in;\n            // otherwise leave unsignalled so the implementor's output pipeline\n            // owns turn completion (autoAck defaults to false).\n            if (merged.autoAck) ctx.ack()\n            return\n          }\n          for (const call of calls) {\n            if (ctx.abortSignal.aborted) return\n            await executeAndPersistToolCall(call)\n          }\n          // Tool calls produced — do NOT ack; the runner will iterate again.\n        }\n\n        try {\n          for await (const chunk of chunks) {\n            if (ctx.abortSignal.aborted) return\n            const delta = chunk.choices?.[0]?.delta\n            if (!delta) continue\n            if (typeof delta.content === 'string' && delta.content.length > 0) {\n              sawMessageDelta = true\n              partialMessageContent += delta.content\n              helpers.reportMessage(streamId, delta.content)\n            }\n            const reasoning = (delta as { reasoning_content?: string | null }).reasoning_content\n            if (typeof reasoning === 'string' && reasoning.length > 0) {\n              sawThoughtDelta = true\n              partialThoughtContent += reasoning\n              helpers.reportThought(streamId, reasoning)\n            }\n            if (Array.isArray(delta.tool_calls)) {\n              for (const d of delta.tool_calls) {\n                accumulator.feed(d)\n              }\n            }\n          }\n          await drainAndPersist()\n        } catch (err) {\n          if (ctx.abortSignal.aborted) return\n          helpers.log.error({\n            kind: 'stream-error',\n            message: `WebLLM stream failed: ${isError(err) ? err.message : String(err)}`,\n            payload: { detail: isError(err) ? err.message : String(err) },\n          })\n          ctx.nack(\n            new E_WEBLLM_CHAT_COMPLETIONS_STREAM_ERROR([isError(err) ? err.message : String(err)])\n          )\n          return\n        }\n        return\n      }\n\n      // ── Step 9: non-streaming path ────────────────────────────────────────\n      const parsed = completion as ChatCompletionsResponse\n      const choice = parsed.choices?.[0]\n      if (!choice) {\n        // Empty response, no tool calls — terminal. Self-ack only when opted in.\n        if (merged.autoAck) ctx.ack()\n        return\n      }\n      const msg = choice.message\n      const responseId = parsed.id ?? uuidv6()\n\n      if (msg && typeof msg.content === 'string' && msg.content.length > 0) {\n        const messageId = `${responseId}:message`\n        helpers.reportMessage(messageId, msg.content, { isComplete: true })\n        await ctx.storeMessage(\n          new Message({\n            id: messageId,\n            role: 'assistant',\n            content: msg.content,\n            identity: selfIdentity,\n            createdAt: nowIso(),\n            updatedAt: nowIso(),\n          })\n        )\n      }\n      const reasoning = (msg as { reasoning_content?: string | null } | undefined)\n        ?.reasoning_content\n      if (typeof reasoning === 'string' && reasoning.length > 0) {\n        const thoughtId = `${responseId}:thought`\n        helpers.reportThought(thoughtId, reasoning, { isComplete: true })\n        await ctx.storeThought(\n          new Thought({\n            id: thoughtId,\n            content: reasoning,\n            identity: selfIdentity,\n            createdAt: nowIso(),\n            updatedAt: nowIso(),\n          })\n        )\n      }\n\n      const rawCalls = msg?.tool_calls ?? []\n      if (rawCalls.length === 0) {\n        // No tool calls — terminal text answer. Self-ack only when opted in;\n        // otherwise the implementor's output pipeline owns completion.\n        if (merged.autoAck) ctx.ack()\n        return\n      }\n      const calls: AssembledToolCall[] = rawCalls.map((tc) => ({\n        id: tc.id,\n        type: tc.type ?? 'function',\n        name: tc.function?.name ?? '',\n        args: tc.function?.arguments ?? '',\n      }))\n      for (const call of calls) {\n        if (ctx.abortSignal.aborted) return\n        await executeAndPersistToolCall(call)\n      }\n      // Tool calls produced — do NOT ack; the runner will iterate again.\n    }\n  }\n\n  /**\n   * Returns `true` when `value` is an {@link WebLLMChatCompletionsAdapter} instance.\n   *\n   * @param value - The value to test.\n   * @returns `true` when `value` is an `WebLLMChatCompletionsAdapter` instance.\n   */\n  public static isWebLLMChatCompletionsAdapter(\n    value: unknown\n  ): value is WebLLMChatCompletionsAdapter {\n    return isInstanceOf(value, 'WebLLMChatCompletionsAdapter', WebLLMChatCompletionsAdapter)\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"adapter.cjs","names":["#baseline","#engine","#resolveEngine","#enginePromise"],"sources":["../../../../src/batteries/llm/webllm_chat_completions/adapter.ts"],"sourcesContent":["/**\n * Cross-environment executor adapter for WebLLM Chat Completions compatible endpoints.\n *\n * @module @nhtio/adk/batteries/llm/webllm_chat_completions/adapter\n *\n * @remarks\n * Cross-environment LLM adapter for the WebLLM Chat Completions wire shape. Chat Completions was\n * chosen as the ADK's reference adapter because it is the de-facto interchange format for the\n * majority of OpenAI-compatible gateways (vLLM, Together, Groq, Fireworks, Ollama, Azure OpenAI,\n * OpenRouter, DeepSeek, Mistral La Plateforme, and most self-hosted deployments). Its tool-call\n * synthetic-history shape (`role: 'assistant', tool_calls: [...]` followed by `role: 'tool'` with\n * `tool_call_id`) is the lowest-common-denominator that every conformant gateway accepts.\n *\n * The adapter is built around three pluggable layers:\n *\n * 1. **Translation helpers** — the thirteen swappable functions exported from `./helpers` turn\n *    ADK primitives ({@link @nhtio/adk!Tokenizable}, {@link @nhtio/adk!Memory}, {@link @nhtio/adk!Message}, {@link @nhtio/adk!Thought},\n *    {@link @nhtio/adk!ToolCall}, {@link @nhtio/adk!Tool}, {@link @nhtio/adk!ArtifactTool}, {@link @nhtio/adk!SpooledArtifact}) into Chat\n *    Completions wire shapes. Consumers override individual helpers via `options.helpers.*` to\n *    customise envelope formats, bucket ordering, thought surfacing, or JSON Schema generation\n *    without forking the adapter.\n * 2. **Three-layer options merging** — constructor baseline, per-`executor()` overrides, and\n *    per-iteration `ctx.stash.webLLMChatCompletions` overrides combine with key-by-key\n *    precedence for `helpers` and wholesale replacement for everything else.\n *    The merged shape is re-validated on every iteration so a malformed stash override\n *    fails loud, not silently.\n * 3. **WebLLM engine invocation** — accepts a preloaded `engine` or lazy `createEngine` factory.\n *    The resolved request body is passed directly to WebLLM's OpenAI-compatible chat API.\n *\n * Per-iteration flow (steps 1–9 of the plan):\n * 1. Merge constructor / executor / stash options and re-validate.\n * 2. Resolve helpers, falling back to bundled `default*` for each unset field.\n * 3. Forge artifact-query tools by walking `ctx.turnToolCalls`, collecting unique\n *    `SpooledArtifact` constructors, calling `<Ctor>.forgeTools(ctx)` on each, and merging the\n *    results with `ctx.tools`.\n * 4. Pre-render every persisted tool-call result into the prompt-ready string the timeline will\n *    use, cached by `tc.id`.\n * 5. When `tokenEncoding !== null`, sum the token weight of every persisted bucket and throw\n *    {@link @nhtio/adk/batteries!E_WEBLLM_CHAT_COMPLETIONS_CONTEXT_OVERFLOW} when the total exceeds `contextWindow`.\n * 6. Build the request body via `buildChatCompletionsHistory`; carry vendor-opaque reasoning\n *    blocks through the `_adk_reasoning_payloads` side-channel.\n * 7. Resolve or lazily create a WebLLM engine and call `engine.chat.completions.create(body)`.\n * 8. Streaming path: consume WebLLM's async chunk iterable; surface deltas through\n *    `helpers.reportMessage` / `reportThought` / `reportToolCall`; assemble tool-call deltas via\n *    the accumulator; persist `Message` / `Thought` / `ToolCall` records on stream end.\n * 9. Non-streaming path: consume the returned Chat Completion object; same persistence +\n *    tool-execution loop.\n */\n\nimport { DateTime } from 'luxon'\nimport { sha256 } from 'js-sha256'\nimport { v6 as uuidv6 } from 'uuid'\nimport { validateOptions } from './validation'\nimport { isError, isInstanceOf, isObject } from '@nhtio/adk/guards'\nimport { canonicalStringify } from '../../../lib/utils/canonical_json'\nimport { InMemorySpoolStore } from '@nhtio/adk/batteries/storage/in_memory'\nimport {\n  Tokenizable,\n  ToolRegistry,\n  ToolCall,\n  Message,\n  Thought,\n  SpooledArtifact,\n  Media,\n  ArtifactTool,\n} from '@nhtio/adk/common'\nimport {\n  E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS,\n  E_WEBLLM_CHAT_COMPLETIONS_CONTEXT_OVERFLOW,\n  E_WEBLLM_CHAT_COMPLETIONS_STREAM_ERROR,\n  E_WEBLLM_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS,\n} from './exceptions'\nimport {\n  defaultDescriptionToChatCompletionsJsonSchema,\n  defaultRenderUntrustedContent,\n  defaultRenderTrustedContent,\n  defaultRenderStandingInstructions,\n  defaultRenderMemories,\n  defaultRenderRetrievables,\n  defaultRenderRetrievableSafetyDirective,\n  defaultRenderFirstPartyRetrievables,\n  defaultRenderThirdPartyPublicRetrievables,\n  defaultRenderThirdPartyPrivateRetrievables,\n  defaultRenderTimelineMessage,\n  defaultRenderThought,\n  defaultFilterThoughts,\n  defaultToolsToChatCompletionsTools,\n  defaultRenderChatCompletionsSystemPrompt,\n  defaultRenderChatCompletionsToolCallResult,\n  defaultBuildChatCompletionsHistory,\n  defaultCreateChatCompletionsToolCallDeltaAccumulator,\n} from './helpers'\nimport type { DispatchContext } from '@nhtio/adk/types'\nimport type { Tool, Memory, TokenEncoding } from '@nhtio/adk/common'\nimport type { DispatchExecutorFn, DispatchExecutorHelpers } from '@nhtio/adk/dispatch_runner'\nimport type {\n  WebLLMChatCompletionsAdapterOptions,\n  ChatCompletionsHelpers,\n  WebLLMChatCompletionsRequestBody,\n  ChatCompletionsChunk,\n  ChatCompletionsResponse,\n  AssembledToolCall,\n  ChatCompletionsContentBlock,\n  WebLLMEngine,\n} from './types'\n\n// ─── ADK-control keys (stripped before sending the request body) ──────────\n\nconst ADK_CONTROL_KEYS: ReadonlySet<string> = new Set([\n  'engine',\n  'createEngine',\n  'engineConfig',\n  'chatOptions',\n  'stream',\n  'bucketOrder',\n  'contextWindow',\n  'selfIdentity',\n  'thoughtSurfacing',\n  'tokenEncoding',\n  'replayCompatibility',\n  'helpers',\n  'strictToolChoice',\n  'unsupportedMediaPolicy',\n  'onInitProgress',\n  'isWebGPUAvailable',\n  'autoAck',\n])\n\n// ─── Option merging ───────────────────────────────────────────────────────────\n\nconst mergeHelpers = (\n  layers: ReadonlyArray<Partial<ChatCompletionsHelpers> | undefined>\n): Partial<ChatCompletionsHelpers> | undefined => {\n  let merged: Partial<ChatCompletionsHelpers> | undefined\n  for (const layer of layers) {\n    if (!layer) continue\n    merged = { ...(merged ?? {}), ...layer }\n  }\n  return merged\n}\n\nconst mergeOptions = (\n  baseline: WebLLMChatCompletionsAdapterOptions,\n  exec: Partial<WebLLMChatCompletionsAdapterOptions> | undefined,\n  stash: Partial<WebLLMChatCompletionsAdapterOptions> | undefined\n): Partial<WebLLMChatCompletionsAdapterOptions> => {\n  const layers = [baseline as Partial<WebLLMChatCompletionsAdapterOptions>, exec ?? {}, stash ?? {}]\n  const out: Record<string, unknown> = {}\n  for (const layer of layers) {\n    for (const [k, v] of Object.entries(layer)) {\n      if (v === undefined) continue\n      if (k === 'helpers') continue\n      out[k] = v\n    }\n  }\n  const helpers = mergeHelpers(layers.map((l) => l.helpers))\n  if (helpers !== undefined) out.helpers = helpers\n  return out as Partial<WebLLMChatCompletionsAdapterOptions>\n}\n\n// ─── Helper resolution ────────────────────────────────────────────────────────\n\nconst resolveHelpers = (\n  overrides: Partial<ChatCompletionsHelpers> | undefined\n): ChatCompletionsHelpers => {\n  const src = overrides ?? {}\n  return {\n    descriptionToChatCompletionsJsonSchema:\n      src.descriptionToChatCompletionsJsonSchema ?? defaultDescriptionToChatCompletionsJsonSchema,\n    renderUntrustedContent: src.renderUntrustedContent ?? defaultRenderUntrustedContent,\n    renderTrustedContent: src.renderTrustedContent ?? defaultRenderTrustedContent,\n    renderStandingInstructions: src.renderStandingInstructions ?? defaultRenderStandingInstructions,\n    renderMemories: src.renderMemories ?? defaultRenderMemories,\n    renderRetrievables: src.renderRetrievables ?? defaultRenderRetrievables,\n    renderRetrievableSafetyDirective:\n      src.renderRetrievableSafetyDirective ?? defaultRenderRetrievableSafetyDirective,\n    renderFirstPartyRetrievables:\n      src.renderFirstPartyRetrievables ?? defaultRenderFirstPartyRetrievables,\n    renderThirdPartyPublicRetrievables:\n      src.renderThirdPartyPublicRetrievables ?? defaultRenderThirdPartyPublicRetrievables,\n    renderThirdPartyPrivateRetrievables:\n      src.renderThirdPartyPrivateRetrievables ?? defaultRenderThirdPartyPrivateRetrievables,\n    renderTimelineMessage: src.renderTimelineMessage ?? defaultRenderTimelineMessage,\n    renderThought: src.renderThought ?? defaultRenderThought,\n    filterThoughts: src.filterThoughts ?? defaultFilterThoughts,\n    toolsToChatCompletionsTools:\n      src.toolsToChatCompletionsTools ?? defaultToolsToChatCompletionsTools,\n    renderChatCompletionsSystemPrompt:\n      src.renderChatCompletionsSystemPrompt ?? defaultRenderChatCompletionsSystemPrompt,\n    renderChatCompletionsToolCallResult:\n      src.renderChatCompletionsToolCallResult ?? defaultRenderChatCompletionsToolCallResult,\n    buildChatCompletionsHistory:\n      src.buildChatCompletionsHistory ?? defaultBuildChatCompletionsHistory,\n    createChatCompletionsToolCallDeltaAccumulator:\n      src.createChatCompletionsToolCallDeltaAccumulator ??\n      defaultCreateChatCompletionsToolCallDeltaAccumulator,\n  }\n}\n\n// ─── ID helpers ───────────────────────────────────────────────────────────────\n\n// Canonical (key-order-insensitive) checksum — MUST match the contract documented\n// on canonicalStringify and used by Tool.executor + dispatch_runner's streaming\n// helper, so ctx.toolCallCount(checksum) detects semantically-identical repeat\n// calls regardless of argument key order.\nconst computeChecksum = (tool: string, args: unknown): string =>\n  sha256(canonicalStringify({ tool, args }))\n\nconst nowIso = (): string => DateTime.now().toISO() ?? new Date().toISOString()\n\n// ─── Token measurement ────────────────────────────────────────────────────────\n\nconst estimateTokensOf = async (\n  value: { estimateTokens: (encoding: TokenEncoding) => number | Promise<number> },\n  encoding: TokenEncoding\n): Promise<number> => {\n  return Promise.resolve(value.estimateTokens(encoding))\n}\n\n// ─── Adapter class ────────────────────────────────────────────────────────────\n\n/**\n * Opinionated cross-environment LLM adapter for the WebLLM Chat Completions wire shape.\n *\n * @remarks\n * Construction validates options eagerly via {@link @nhtio/adk/batteries!validateOptions} and throws\n * {@link @nhtio/adk/batteries!E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS} on failure — config bugs fail loud, not at\n * dispatch time. The returned instance is reusable: call {@link WebLLMChatCompletionsAdapter.executor}\n * once per `DispatchRunner` configuration to obtain an {@link @nhtio/adk!DispatchExecutorFn} bound to the\n * baseline plus optional executor-scope overrides.\n *\n * Per-iteration overrides live on the active {@link @nhtio/adk!DispatchContext}'s\n * `stash.webLLMChatCompletions` slot and take highest precedence — they merge into the\n * executor-scope shape on every iteration. `helpers` merge key-by-key across all three layers;\n * every other field is replaced wholesale at the highest layer that\n * sets it.\n */\nexport class WebLLMChatCompletionsAdapter {\n  /**\n   * Customary key for per-iteration overrides on `ctx.stash`. The adapter reads\n   * `ctx.stash.get(WebLLMChatCompletionsAdapter.STASH_KEY, {})` at the start of every\n   * iteration and merges the value into the resolved options shape.\n   */\n  public static readonly STASH_KEY = 'webLLMChatCompletions' as const\n\n  readonly #baseline: WebLLMChatCompletionsAdapterOptions\n  #engine: WebLLMEngine | undefined\n  #enginePromise: Promise<WebLLMEngine> | undefined\n\n  public static isAvailable(): boolean {\n    return (\n      typeof globalThis.navigator !== 'undefined' &&\n      'gpu' in globalThis.navigator &&\n      typeof (globalThis.navigator as { gpu?: unknown }).gpu !== 'undefined'\n    )\n  }\n\n  /**\n   * @param options - Constructor-baseline options. Re-validated on every iteration after\n   *   per-dispatch and per-iteration overrides are layered in.\n   * @throws {@link @nhtio/adk/batteries!E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS} when `options` does not satisfy\n   *   {@link @nhtio/adk/batteries!webLLMChatCompletionsOptionsSchema}.\n   */\n  constructor(options: unknown) {\n    this.#baseline = validateOptions(options)\n    this.#engine = this.#baseline.engine\n  }\n\n  async preload(overrides?: Partial<WebLLMChatCompletionsAdapterOptions>): Promise<WebLLMEngine> {\n    const merged = validateOptions(mergeOptions(this.#baseline, overrides, undefined))\n    return this.#resolveEngine(merged)\n  }\n\n  reset(): void {\n    this.#engine = undefined\n    this.#enginePromise = undefined\n  }\n\n  isAvailable(): boolean {\n    return (this.#baseline.isWebGPUAvailable ?? WebLLMChatCompletionsAdapter.isAvailable)()\n  }\n\n  async #resolveEngine(merged: WebLLMChatCompletionsAdapterOptions): Promise<WebLLMEngine> {\n    if (merged.engine) {\n      this.#engine = merged.engine\n      return merged.engine\n    }\n    if (this.#engine) return this.#engine\n    const available = (merged.isWebGPUAvailable ?? WebLLMChatCompletionsAdapter.isAvailable)()\n    if (!available) {\n      throw new E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS([\n        'WebLLM requires a browser/runtime with WebGPU support',\n      ])\n    }\n    this.#enginePromise ??= (async () => {\n      const createEngine =\n        merged.createEngine ??\n        (async ({ model, engineConfig, chatOptions, onInitProgress }) => {\n          const { CreateMLCEngine } = await import('@mlc-ai/web-llm')\n          return (await CreateMLCEngine(\n            model,\n            { ...(engineConfig ?? {}), initProgressCallback: onInitProgress },\n            chatOptions\n          )) as WebLLMEngine\n        })\n      const engine = await createEngine({\n        model: merged.model,\n        engineConfig: merged.engineConfig,\n        chatOptions: merged.chatOptions,\n        onInitProgress: merged.onInitProgress,\n      })\n      this.#engine = engine\n      return engine\n    })()\n    return this.#enginePromise\n  }\n\n  /**\n   * Returns an {@link @nhtio/adk!DispatchExecutorFn} bound to this adapter's baseline plus optional\n   * executor-scope overrides. The returned function is reusable across iterations — every\n   * iteration re-merges with `ctx.stash[STASH_KEY]` and re-validates the result.\n   *\n   * @param overrides - Optional executor-scope overrides. Higher precedence than the baseline,\n   *   lower precedence than `ctx.stash[STASH_KEY]`.\n   * @returns An {@link @nhtio/adk!DispatchExecutorFn} suitable for `DispatchRunner`.\n   */\n  executor(overrides?: Partial<WebLLMChatCompletionsAdapterOptions>): DispatchExecutorFn {\n    const baseline = this.#baseline\n    const adapterClass = WebLLMChatCompletionsAdapter\n    return async (ctx: DispatchContext, helpers: DispatchExecutorHelpers): Promise<void> => {\n      // Bridge helpers.log → the legacy `warn: (msg) => void` slot exposed by the per-call\n      // helper signatures. Helpers downstream don't need to know the structured shape — they\n      // emit a single string, which we route to `helpers.log.warn` with a stable `kind` so\n      // observability middleware can still filter and aggregate.\n      const localWarn = (msg: string): void => {\n        helpers.log.warn({ kind: 'helper-warning', message: msg })\n      }\n\n      // ── Step 1: merge & validate ──────────────────────────────────────────\n      const stashRaw = ctx.stash.get(adapterClass.STASH_KEY, {}) as unknown\n      const stashOverrides =\n        stashRaw && typeof stashRaw === 'object'\n          ? (stashRaw as Partial<WebLLMChatCompletionsAdapterOptions>)\n          : {}\n      const mergedRaw = mergeOptions(baseline, overrides, stashOverrides)\n      const merged = validateOptions(mergedRaw)\n\n      // Cross-field invariant: tokenEncoding non-null requires contextWindow.\n      if (merged.tokenEncoding !== null && merged.contextWindow === undefined) {\n        throw new E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS([\n          'tokenEncoding is non-null but contextWindow is undefined',\n        ])\n      }\n\n      // ── Step 2: resolve helpers ───────────────────────────────────────────\n      const resolvedHelpers = resolveHelpers(merged.helpers)\n\n      // ── Step 3: forge artifact-query tools ────────────────────────────────\n      const uniqueCtors = new Set<typeof SpooledArtifact>()\n      for (const tc of ctx.turnToolCalls) {\n        const results = tc.results as unknown as { constructor?: unknown }\n        const ctor = results?.constructor\n        if (ctor && SpooledArtifact.isSpooledArtifactConstructor(ctor)) {\n          uniqueCtors.add(ctor as unknown as typeof SpooledArtifact)\n        }\n      }\n      const forgedRegistries: ToolRegistry[] = []\n      for (const ctor of uniqueCtors) {\n        const forgeFn = (\n          ctor as unknown as {\n            forgeTools?: (c: DispatchContext) => ToolRegistry\n          }\n        ).forgeTools\n        if (typeof forgeFn === 'function') {\n          forgedRegistries.push(forgeFn.call(ctor, ctx))\n        }\n      }\n      const mergedRegistry = ToolRegistry.merge([ctx.tools, ...forgedRegistries], {\n        onCollision: 'replace',\n      })\n      mergedRegistry.bindContext(ctx)\n\n      // ── Step 4: pre-render tool-call results ──────────────────────────────\n      const renderedToolCallResults = new Map<string, string | ChatCompletionsContentBlock[]>()\n      for (const tc of ctx.turnToolCalls) {\n        const rendered = await resolvedHelpers.renderChatCompletionsToolCallResult({\n          toolCall: tc,\n          results: tc.results as\n            | Tokenizable\n            | SpooledArtifact\n            | SpooledArtifact[]\n            | Media\n            | Media[],\n          tool: mergedRegistry.get(tc.tool) as Tool | ArtifactTool | undefined,\n          renderUntrustedContent: resolvedHelpers.renderUntrustedContent,\n          renderTrustedContent: resolvedHelpers.renderTrustedContent,\n          unsupportedMediaPolicy: merged.unsupportedMediaPolicy ?? 'throw',\n          warn: localWarn,\n        })\n        renderedToolCallResults.set(tc.id, rendered)\n      }\n\n      // ── Step 5: context window enforcement ────────────────────────────────\n      if (merged.tokenEncoding !== null && merged.contextWindow !== undefined) {\n        const encoding = merged.tokenEncoding as TokenEncoding\n        let spTokens = await estimateTokensOf(ctx.systemPrompt, encoding)\n        let siTokens = 0\n        for (const si of ctx.standingInstructions) {\n          siTokens += await estimateTokensOf(si, encoding)\n        }\n        let memTokens = 0\n        for (const mem of ctx.turnMemories as Set<Memory>) {\n          memTokens += await estimateTokensOf(mem.content, encoding)\n        }\n        let retTokens = 0\n        for (const r of ctx.turnRetrievables) {\n          retTokens += await estimateTokensOf(r.content, encoding)\n        }\n        let tlTokens = 0\n        for (const msg of ctx.turnMessages) {\n          if (msg.content !== undefined) {\n            tlTokens += await estimateTokensOf(msg.content, encoding)\n          }\n        }\n        for (const th of ctx.turnThoughts) {\n          tlTokens += await estimateTokensOf(th.content, encoding)\n        }\n        for (const rendered of renderedToolCallResults.values()) {\n          const textPart =\n            typeof rendered === 'string'\n              ? rendered\n              : rendered\n                  .filter((b): b is { type: 'text'; text: string } => b.type === 'text')\n                  .map((b) => b.text)\n                  .join('\\n')\n          const tk = new Tokenizable(textPart)\n          tlTokens += await estimateTokensOf(tk, encoding)\n        }\n        const total = spTokens + siTokens + memTokens + retTokens + tlTokens\n        const perBucketObj = {\n          systemPrompt: spTokens,\n          standingInstructions: siTokens,\n          memories: memTokens,\n          retrievables: retTokens,\n          timeline: tlTokens,\n        }\n        helpers.log.debug({\n          kind: 'context-window-usage',\n          message: `Context window usage: ${total}/${merged.contextWindow} tokens`,\n          payload: {\n            total,\n            limit: merged.contextWindow,\n            encoding,\n            perBucket: perBucketObj,\n          },\n        })\n        if (total > merged.contextWindow) {\n          const perBucket = JSON.stringify(perBucketObj)\n          throw new E_WEBLLM_CHAT_COMPLETIONS_CONTEXT_OVERFLOW([\n            total,\n            merged.contextWindow,\n            encoding,\n            perBucket,\n          ])\n        }\n      }\n\n      // ── Step 5b: tool_choice + forged artifact-tools guard ────────────────\n      // When `tool_choice` (or the `allowed_tools` variant) forces the model onto a specific\n      // tool name and that name resolves to an ephemeral, forged artifact-query tool, surface\n      // it as a structured warning (or throw under `strictToolChoice: true`). Forging an\n      // artifact-query tool by name is almost always a misconfiguration — the tool may not\n      // exist in the next iteration once the artifact ages out of `ctx.turnToolCalls`.\n      const forcedToolNames: string[] = []\n      const toolChoice = merged.tool_choice\n      let toolChoiceVariant: 'function' | 'allowed_tools' = 'function'\n      if (toolChoice && typeof toolChoice === 'object') {\n        if ('function' in toolChoice && toolChoice.type === 'function') {\n          forcedToolNames.push(toolChoice.function.name)\n        } else if ('custom' in toolChoice && toolChoice.type === 'custom') {\n          forcedToolNames.push(toolChoice.custom.name)\n        } else if (toolChoice.type === 'allowed_tools') {\n          toolChoiceVariant = 'allowed_tools'\n          for (const entry of toolChoice.allowed_tools.tools) {\n            if ('function' in entry) forcedToolNames.push(entry.function.name)\n            else if ('custom' in entry) forcedToolNames.push(entry.custom.name)\n          }\n        }\n      }\n      const forcedForgedHits: Array<{ toolName: string }> = []\n      for (const name of forcedToolNames) {\n        const t = mergedRegistry.get(name) as { ephemeral?: boolean } | undefined\n        if (t?.ephemeral === true) {\n          forcedForgedHits.push({ toolName: name })\n        }\n      }\n      if (forcedForgedHits.length > 0) {\n        if (merged.strictToolChoice === true) {\n          throw new E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS([\n            `tool_choice forces forged ephemeral artifact-query tool(s): ${forcedForgedHits\n              .map((h) => h.toolName)\n              .join(\n                ', '\n              )} — these may not exist on the next iteration. Remove the override or unset strictToolChoice.`,\n          ])\n        }\n        helpers.log.warn({\n          kind: 'tool-choice-forged-artifact',\n          message: `tool_choice forces ${forcedForgedHits.length} forged ephemeral artifact-query tool(s); this is almost always a misconfiguration`,\n          payload: {\n            toolNames: forcedForgedHits.map((h) => h.toolName),\n            variant: toolChoiceVariant,\n          },\n        })\n      }\n\n      // ── Step 6: build request body ────────────────────────────────────────\n      const { messages: wireMessages, reasoningPayloads } =\n        await resolvedHelpers.buildChatCompletionsHistory({\n          systemPrompt: ctx.systemPrompt,\n          standingInstructions: ctx.standingInstructions,\n          memories: ctx.turnMemories,\n          retrievables: ctx.turnRetrievables,\n          messages: ctx.turnMessages,\n          thoughts: ctx.turnThoughts,\n          toolCalls: ctx.turnToolCalls,\n          tools: mergedRegistry,\n          renderedToolCallResults,\n          bucketOrder: merged.bucketOrder ?? [\n            'standingInstructions',\n            'memories',\n            'retrievables',\n            'timeline',\n          ],\n          selfIdentity: merged.selfIdentity ?? 'assistant',\n          thoughtSurfacing: merged.thoughtSurfacing ?? 'all-self',\n          replayCompatibility: merged.replayCompatibility ?? [],\n          renderChatCompletionsToolCallResult: resolvedHelpers.renderChatCompletionsToolCallResult,\n          renderChatCompletionsSystemPrompt: resolvedHelpers.renderChatCompletionsSystemPrompt,\n          renderStandingInstructions: resolvedHelpers.renderStandingInstructions,\n          renderMemories: resolvedHelpers.renderMemories,\n          renderRetrievables: resolvedHelpers.renderRetrievables,\n          renderRetrievableSafetyDirective: resolvedHelpers.renderRetrievableSafetyDirective,\n          renderFirstPartyRetrievables: resolvedHelpers.renderFirstPartyRetrievables,\n          renderThirdPartyPublicRetrievables: resolvedHelpers.renderThirdPartyPublicRetrievables,\n          renderThirdPartyPrivateRetrievables: resolvedHelpers.renderThirdPartyPrivateRetrievables,\n          renderTimelineMessage: resolvedHelpers.renderTimelineMessage,\n          renderThought: resolvedHelpers.renderThought,\n          filterThoughts: resolvedHelpers.filterThoughts,\n          renderUntrustedContent: resolvedHelpers.renderUntrustedContent,\n          renderTrustedContent: resolvedHelpers.renderTrustedContent,\n          unsupportedMediaPolicy: merged.unsupportedMediaPolicy ?? 'throw',\n          warn: localWarn,\n        })\n\n      const stream = merged.stream ?? true\n      const body: WebLLMChatCompletionsRequestBody = {\n        model: merged.model,\n        messages: wireMessages,\n        stream,\n      }\n      for (const [k, v] of Object.entries(merged)) {\n        if (ADK_CONTROL_KEYS.has(k)) continue\n        if (k === 'model' || k === 'messages' || k === 'stream') continue\n        if (v === undefined) continue\n        ;(body as Record<string, unknown>)[k] = v\n      }\n      const toolsArr = mergedRegistry.all()\n      if (toolsArr.length > 0) {\n        body.tools = resolvedHelpers.toolsToChatCompletionsTools(toolsArr, {\n          descriptionToChatCompletionsJsonSchema:\n            resolvedHelpers.descriptionToChatCompletionsJsonSchema,\n        })\n      }\n      if (reasoningPayloads.length > 0) {\n        body._adk_reasoning_payloads = reasoningPayloads\n      }\n\n      // ── Step 7: invoke WebLLM engine ─────────────────────────────────────\n      let completion: ChatCompletionsResponse | AsyncIterable<ChatCompletionsChunk>\n      try {\n        const engine = await this.#resolveEngine(merged)\n        completion = (await engine.chat.completions.create(body as never)) as\n          | ChatCompletionsResponse\n          | AsyncIterable<ChatCompletionsChunk>\n      } catch (err) {\n        helpers.log.error({\n          kind: 'webllm-engine-error',\n          message: `WebLLM engine failure: ${isError(err) ? err.message : String(err)}`,\n          payload: { detail: isError(err) ? err.message : String(err) },\n        })\n        ctx.nack(\n          new E_WEBLLM_CHAT_COMPLETIONS_STREAM_ERROR([isError(err) ? err.message : String(err)])\n        )\n        return\n      }\n\n      // Spool store used to back string / Uint8Array tool returns. Bytes are written under the\n      // call id; the resulting SpooledArtifact (or tool-configured subclass) is the model-visible\n      // handle for the rest of the turn. Injectable via the `spoolStore` option so consumers can\n      // back artifacts with durable storage (OPFS, Flydrive); defaults to an ephemeral per-dispatch\n      // in-memory store. NOTE: an injected durable store persists across turns, so call ids must be\n      // globally unique for that store (see the `spoolStore` option docs).\n      const spoolStore = merged.spoolStore ?? new InMemorySpoolStore()\n\n      // ── Inner helper: persist + execute one assembled tool call ───────────\n      const executeAndPersistToolCall = async (call: AssembledToolCall): Promise<void> => {\n        const tool = mergedRegistry.get(call.name)\n        // Parse args defensively. The model may emit non-JSON or a non-object\n        // JSON value (string, number, array, null); both are recoverable error\n        // conditions, NOT dispatch-killers. A parse failure short-circuits to\n        // a persisted error ToolCall — formatted by `E_WEBLLM_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS`\n        // so consumers can match on the stable error code — letting the model\n        // self-correct on the next iteration.\n        let args: Record<string, unknown> = {}\n        let parseError:\n          | InstanceType<typeof E_WEBLLM_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS>\n          | undefined\n        if (call.args && call.args.length > 0) {\n          try {\n            const parsed: unknown = JSON.parse(call.args)\n            if (isObject(parsed)) {\n              args = parsed\n            } else {\n              const receivedKind = Array.isArray(parsed)\n                ? 'array'\n                : parsed === null\n                  ? 'null'\n                  : typeof parsed\n              parseError = new E_WEBLLM_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS([\n                `must be a JSON object; received ${receivedKind}`,\n                call.args,\n              ])\n            }\n          } catch {\n            parseError = new E_WEBLLM_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS([\n              'are not valid JSON',\n              call.args,\n            ])\n          }\n        }\n        const completedAt = nowIso()\n        if (parseError !== undefined) {\n          const results = new Tokenizable(parseError.message)\n          helpers.reportToolCall(call.id, { tool: call.name, args })\n          helpers.reportToolCall(call.id, {\n            results,\n            isError: true,\n            isComplete: true,\n          })\n          const checksum = computeChecksum(call.name, args)\n          await ctx.storeToolCall(\n            new ToolCall({\n              id: call.id,\n              tool: call.name,\n              args,\n              checksum,\n              isComplete: true,\n              isError: true,\n              results,\n              createdAt: completedAt,\n              updatedAt: completedAt,\n              completedAt,\n            })\n          )\n          return\n        }\n        if (!tool) {\n          // List the tools that DO exist so the model can self-correct on the next iteration\n          // instead of guessing. Without this, a single typo'd / hallucinated tool name yields\n          // a dead-end \"not found\" with no path forward.\n          const available = mergedRegistry\n            .all()\n            .map((t) => t.name)\n            .sort()\n          const errText =\n            available.length > 0\n              ? `Tool not found: ${call.name}. Available tools: ${available.join(', ')}.`\n              : `Tool not found: ${call.name}. No tools are available this turn.`\n          const results = new Tokenizable(errText)\n          helpers.reportToolCall(call.id, { tool: call.name, args })\n          helpers.reportToolCall(call.id, {\n            results,\n            isError: true,\n            isComplete: true,\n          })\n          const checksum = computeChecksum(call.name, args)\n          await ctx.storeToolCall(\n            new ToolCall({\n              id: call.id,\n              tool: call.name,\n              args,\n              checksum,\n              isComplete: true,\n              isError: true,\n              results,\n              createdAt: completedAt,\n              updatedAt: completedAt,\n              completedAt,\n            })\n          )\n          return\n        }\n        helpers.reportToolCall(call.id, { tool: tool.name, args })\n        const isArtifactTool = ArtifactTool.isArtifactTool(tool)\n        let results: Tokenizable | SpooledArtifact | SpooledArtifact[] | Media | Media[] =\n          new Tokenizable('')\n        let toolHadError = false\n        try {\n          const raw = await tool.executor(ctx)(args)\n          if (isArtifactTool) {\n            // ArtifactTool: handler returns a string | Tokenizable that *is* the model-visible\n            // answer to a query against a prior artifact. No spool write, no SpooledArtifact\n            // construction — pass through (or wrap a bare string in Tokenizable).\n            if (Tokenizable.isTokenizable(raw)) {\n              results = raw\n            } else if (typeof raw === 'string') {\n              results = new Tokenizable(raw)\n            } else {\n              throw new Error(\n                `ArtifactTool \"${tool.name}\" returned a non-string/non-Tokenizable value`\n              )\n            }\n          } else if (Media.isMedia(raw)) {\n            results = raw\n          } else if (Array.isArray(raw) && raw.length > 0 && raw.every((m) => Media.isMedia(m))) {\n            results = raw as Media[]\n          } else if (typeof raw === 'string' || isInstanceOf(raw, 'Uint8Array', Uint8Array)) {\n            const reader = await spoolStore.write(call.id, raw as string | Uint8Array)\n            const ArtifactCtor = (tool as Tool).artifactConstructor?.() ?? SpooledArtifact\n            results = new ArtifactCtor(reader)\n          } else {\n            // Defensive fallback — wrap stringified value so the model gets *something*.\n            const reader = await spoolStore.write(call.id, String(raw))\n            const ArtifactCtor = (tool as Tool).artifactConstructor?.() ?? SpooledArtifact\n            results = new ArtifactCtor(reader)\n          }\n        } catch (err) {\n          toolHadError = true\n          // Surface field-level validation detail from the cause chain so the\n          // model can self-correct on the specific offending field. `E_INVALID_TOOL_ARGS`\n          // carries the joi `ValidationException` on `cause`, whose message is the\n          // joined field-level error text (e.g. `\"text\" is required`).\n          let detailMsg = isError(err) ? err.message : String(err)\n          if (\n            isError(err) &&\n            isError(err.cause) &&\n            err.cause.message &&\n            err.cause.message !== err.message\n          ) {\n            detailMsg = `${detailMsg} ${err.cause.message}`\n          }\n          results = new Tokenizable(detailMsg)\n        }\n        helpers.reportToolCall(call.id, {\n          results,\n          isError: toolHadError,\n          isComplete: true,\n        })\n        const checksum = computeChecksum(tool.name, args)\n        const completedAt2 = nowIso()\n        await ctx.storeToolCall(\n          new ToolCall({\n            id: call.id,\n            tool: tool.name,\n            args,\n            checksum,\n            isComplete: true,\n            isError: toolHadError,\n            results,\n            fromArtifactTool: isArtifactTool,\n            createdAt: completedAt2,\n            updatedAt: completedAt2,\n            completedAt: completedAt2,\n          })\n        )\n      }\n\n      const selfIdentity = merged.selfIdentity ?? 'assistant'\n\n      // ── Step 8: streaming path ────────────────────────────────────────────\n      if (stream) {\n        const chunks = completion as AsyncIterable<ChatCompletionsChunk>\n        if (!chunks || typeof chunks[Symbol.asyncIterator] !== 'function') {\n          ctx.nack(new E_WEBLLM_CHAT_COMPLETIONS_STREAM_ERROR(['engine did not return a stream']))\n          return\n        }\n        const accumulator = resolvedHelpers.createChatCompletionsToolCallDeltaAccumulator()\n        const streamId = uuidv6()\n\n        let partialMessageContent = ''\n        let partialThoughtContent = ''\n        let sawMessageDelta = false\n        let sawThoughtDelta = false\n\n        const drainAndPersist = async (): Promise<void> => {\n          if (sawMessageDelta) {\n            helpers.reportMessage(streamId, '', { isComplete: true })\n            await ctx.storeMessage(\n              new Message({\n                id: streamId,\n                role: 'assistant',\n                content: partialMessageContent,\n                identity: selfIdentity,\n                createdAt: nowIso(),\n                updatedAt: nowIso(),\n              })\n            )\n          }\n          if (sawThoughtDelta) {\n            helpers.reportThought(streamId, '', { isComplete: true })\n            await ctx.storeThought(\n              new Thought({\n                id: streamId,\n                content: partialThoughtContent,\n                identity: selfIdentity,\n                createdAt: nowIso(),\n                updatedAt: nowIso(),\n              })\n            )\n          }\n          const calls = accumulator.drain()\n          helpers.log.debug({\n            kind: 'accumulator-finalised',\n            message: `Stream finalised: ${calls.length} tool call(s), message=${sawMessageDelta}, thought=${sawThoughtDelta}`,\n            payload: { toolCallCount: calls.length, sawMessageDelta, sawThoughtDelta },\n          })\n          if (calls.length === 0) {\n            // No tool calls — terminal text answer. Self-ack only when opted in;\n            // otherwise leave unsignalled so the implementor's output pipeline\n            // owns turn completion (autoAck defaults to false).\n            if (merged.autoAck) ctx.ack()\n            return\n          }\n          for (const call of calls) {\n            if (ctx.abortSignal.aborted) return\n            await executeAndPersistToolCall(call)\n          }\n          // Tool calls produced — do NOT ack; the runner will iterate again.\n        }\n\n        try {\n          for await (const chunk of chunks) {\n            if (ctx.abortSignal.aborted) return\n            const delta = chunk.choices?.[0]?.delta\n            if (!delta) continue\n            if (typeof delta.content === 'string' && delta.content.length > 0) {\n              sawMessageDelta = true\n              partialMessageContent += delta.content\n              helpers.reportMessage(streamId, delta.content)\n            }\n            const reasoning = (delta as { reasoning_content?: string | null }).reasoning_content\n            if (typeof reasoning === 'string' && reasoning.length > 0) {\n              sawThoughtDelta = true\n              partialThoughtContent += reasoning\n              helpers.reportThought(streamId, reasoning)\n            }\n            if (Array.isArray(delta.tool_calls)) {\n              for (const d of delta.tool_calls) {\n                accumulator.feed(d)\n              }\n            }\n          }\n          await drainAndPersist()\n        } catch (err) {\n          if (ctx.abortSignal.aborted) return\n          helpers.log.error({\n            kind: 'stream-error',\n            message: `WebLLM stream failed: ${isError(err) ? err.message : String(err)}`,\n            payload: { detail: isError(err) ? err.message : String(err) },\n          })\n          ctx.nack(\n            new E_WEBLLM_CHAT_COMPLETIONS_STREAM_ERROR([isError(err) ? err.message : String(err)])\n          )\n          return\n        }\n        return\n      }\n\n      // ── Step 9: non-streaming path ────────────────────────────────────────\n      const parsed = completion as ChatCompletionsResponse\n      const choice = parsed.choices?.[0]\n      if (!choice) {\n        // Empty response, no tool calls — terminal. Self-ack only when opted in.\n        if (merged.autoAck) ctx.ack()\n        return\n      }\n      const msg = choice.message\n      const responseId = parsed.id ?? uuidv6()\n\n      if (msg && typeof msg.content === 'string' && msg.content.length > 0) {\n        const messageId = `${responseId}:message`\n        helpers.reportMessage(messageId, msg.content, { isComplete: true })\n        await ctx.storeMessage(\n          new Message({\n            id: messageId,\n            role: 'assistant',\n            content: msg.content,\n            identity: selfIdentity,\n            createdAt: nowIso(),\n            updatedAt: nowIso(),\n          })\n        )\n      }\n      const reasoning = (msg as { reasoning_content?: string | null } | undefined)\n        ?.reasoning_content\n      if (typeof reasoning === 'string' && reasoning.length > 0) {\n        const thoughtId = `${responseId}:thought`\n        helpers.reportThought(thoughtId, reasoning, { isComplete: true })\n        await ctx.storeThought(\n          new Thought({\n            id: thoughtId,\n            content: reasoning,\n            identity: selfIdentity,\n            createdAt: nowIso(),\n            updatedAt: nowIso(),\n          })\n        )\n      }\n\n      const rawCalls = msg?.tool_calls ?? []\n      if (rawCalls.length === 0) {\n        // No tool calls — terminal text answer. Self-ack only when opted in;\n        // otherwise the implementor's output pipeline owns completion.\n        if (merged.autoAck) ctx.ack()\n        return\n      }\n      const calls: AssembledToolCall[] = rawCalls.map((tc) => ({\n        id: tc.id,\n        type: tc.type ?? 'function',\n        name: tc.function?.name ?? '',\n        args: tc.function?.arguments ?? '',\n      }))\n      for (const call of calls) {\n        if (ctx.abortSignal.aborted) return\n        await executeAndPersistToolCall(call)\n      }\n      // Tool calls produced — do NOT ack; the runner will iterate again.\n    }\n  }\n\n  /**\n   * Returns `true` when `value` is an {@link WebLLMChatCompletionsAdapter} instance.\n   *\n   * @param value - The value to test.\n   * @returns `true` when `value` is an `WebLLMChatCompletionsAdapter` instance.\n   */\n  public static isWebLLMChatCompletionsAdapter(\n    value: unknown\n  ): value is WebLLMChatCompletionsAdapter {\n    return isInstanceOf(value, 'WebLLMChatCompletionsAdapter', WebLLMChatCompletionsAdapter)\n  }\n}\n"],"mappings":"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"}

package/batteries/llm/webllm_chat_completions/adapter.mjs

@@ -1,8 +1,8 @@
-import { a as Tokenizable, c as isObject, n as canonicalStringify, o as isError, s as isInstanceOf, t as ToolRegistry } from "../../../tool_registry-CX3ofUh9.mjs";
-import { n as Message, t as Thought } from "../../../thought-D9IS11b5.mjs";
-import { i as ArtifactTool, t as SpooledArtifact } from "../../../spooled_artifact-D-JrpY4W.mjs";
-import "../../../common-ClCHam5-.mjs";
-import { n as Media, t as ToolCall } from "../../../tool_call-Bs_Q5LOG.mjs";
+import { a as Tokenizable, c as isObject, n as canonicalStringify, o as isError, s as isInstanceOf, t as ToolRegistry } from "../../../tool_registry-BGHg6KTq.mjs";
+import { n as Message, t as Thought } from "../../../thought-B_P8LiB6.mjs";
+import { i as ArtifactTool, t as SpooledArtifact } from "../../../spooled_artifact-CWoKUDEm.mjs";
+import "../../../common-lMrnzoyn.mjs";
+import { n as Media, t as ToolCall } from "../../../tool_call-BUeMuCc6.mjs";
 import "../../../guards.mjs";
 import { InMemorySpoolStore } from "../../storage/in_memory.mjs";
 import { defaultBuildChatCompletionsHistory, defaultCreateChatCompletionsToolCallDeltaAccumulator, defaultDescriptionToChatCompletionsJsonSchema, defaultFilterThoughts, defaultRenderChatCompletionsSystemPrompt, defaultRenderChatCompletionsToolCallResult, defaultRenderFirstPartyRetrievables, defaultRenderMemories, defaultRenderRetrievableSafetyDirective, defaultRenderRetrievables, defaultRenderStandingInstructions, defaultRenderThirdPartyPrivateRetrievables, defaultRenderThirdPartyPublicRetrievables, defaultRenderThought, defaultRenderTimelineMessage, defaultRenderTrustedContent, defaultRenderUntrustedContent, defaultToolsToChatCompletionsTools } from "../openai_chat_completions/helpers.mjs";
@@ -433,7 +433,8 @@ var WebLLMChatCompletionsAdapter = class WebLLMChatCompletionsAdapter {
 					return;
 				}
 				if (!tool) {
-					const results = new Tokenizable(`Tool not found: ${call.name}`);
+					const available = mergedRegistry.all().map((t) => t.name).sort();
+					const results = new Tokenizable(available.length > 0 ? `Tool not found: ${call.name}. Available tools: ${available.join(", ")}.` : `Tool not found: ${call.name}. No tools are available this turn.`);
 					helpers.reportToolCall(call.id, {
 						tool: call.name,
 						args

package/batteries/llm/webllm_chat_completions/adapter.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.mjs","names":["#baseline","#engine","#resolveEngine","#enginePromise"],"sources":["../../../../src/batteries/llm/webllm_chat_completions/adapter.ts"],"sourcesContent":["/**\n * Cross-environment executor adapter for WebLLM Chat Completions compatible endpoints.\n *\n * @module @nhtio/adk/batteries/llm/webllm_chat_completions/adapter\n *\n * @remarks\n * Cross-environment LLM adapter for the WebLLM Chat Completions wire shape. Chat Completions was\n * chosen as the ADK's reference adapter because it is the de-facto interchange format for the\n * majority of OpenAI-compatible gateways (vLLM, Together, Groq, Fireworks, Ollama, Azure OpenAI,\n * OpenRouter, DeepSeek, Mistral La Plateforme, and most self-hosted deployments). Its tool-call\n * synthetic-history shape (`role: 'assistant', tool_calls: [...]` followed by `role: 'tool'` with\n * `tool_call_id`) is the lowest-common-denominator that every conformant gateway accepts.\n *\n * The adapter is built around three pluggable layers:\n *\n * 1. **Translation helpers** — the thirteen swappable functions exported from `./helpers` turn\n *    ADK primitives ({@link @nhtio/adk!Tokenizable}, {@link @nhtio/adk!Memory}, {@link @nhtio/adk!Message}, {@link @nhtio/adk!Thought},\n *    {@link @nhtio/adk!ToolCall}, {@link @nhtio/adk!Tool}, {@link @nhtio/adk!ArtifactTool}, {@link @nhtio/adk!SpooledArtifact}) into Chat\n *    Completions wire shapes. Consumers override individual helpers via `options.helpers.*` to\n *    customise envelope formats, bucket ordering, thought surfacing, or JSON Schema generation\n *    without forking the adapter.\n * 2. **Three-layer options merging** — constructor baseline, per-`executor()` overrides, and\n *    per-iteration `ctx.stash.webLLMChatCompletions` overrides combine with key-by-key\n *    precedence for `helpers` and wholesale replacement for everything else.\n *    The merged shape is re-validated on every iteration so a malformed stash override\n *    fails loud, not silently.\n * 3. **WebLLM engine invocation** — accepts a preloaded `engine` or lazy `createEngine` factory.\n *    The resolved request body is passed directly to WebLLM's OpenAI-compatible chat API.\n *\n * Per-iteration flow (steps 1–9 of the plan):\n * 1. Merge constructor / executor / stash options and re-validate.\n * 2. Resolve helpers, falling back to bundled `default*` for each unset field.\n * 3. Forge artifact-query tools by walking `ctx.turnToolCalls`, collecting unique\n *    `SpooledArtifact` constructors, calling `<Ctor>.forgeTools(ctx)` on each, and merging the\n *    results with `ctx.tools`.\n * 4. Pre-render every persisted tool-call result into the prompt-ready string the timeline will\n *    use, cached by `tc.id`.\n * 5. When `tokenEncoding !== null`, sum the token weight of every persisted bucket and throw\n *    {@link @nhtio/adk/batteries!E_WEBLLM_CHAT_COMPLETIONS_CONTEXT_OVERFLOW} when the total exceeds `contextWindow`.\n * 6. Build the request body via `buildChatCompletionsHistory`; carry vendor-opaque reasoning\n *    blocks through the `_adk_reasoning_payloads` side-channel.\n * 7. Resolve or lazily create a WebLLM engine and call `engine.chat.completions.create(body)`.\n * 8. Streaming path: consume WebLLM's async chunk iterable; surface deltas through\n *    `helpers.reportMessage` / `reportThought` / `reportToolCall`; assemble tool-call deltas via\n *    the accumulator; persist `Message` / `Thought` / `ToolCall` records on stream end.\n * 9. Non-streaming path: consume the returned Chat Completion object; same persistence +\n *    tool-execution loop.\n */\n\nimport { DateTime } from 'luxon'\nimport { sha256 } from 'js-sha256'\nimport { v6 as uuidv6 } from 'uuid'\nimport { validateOptions } from './validation'\nimport { isError, isInstanceOf, isObject } from '@nhtio/adk/guards'\nimport { canonicalStringify } from '../../../lib/utils/canonical_json'\nimport { InMemorySpoolStore } from '@nhtio/adk/batteries/storage/in_memory'\nimport {\n  Tokenizable,\n  ToolRegistry,\n  ToolCall,\n  Message,\n  Thought,\n  SpooledArtifact,\n  Media,\n  ArtifactTool,\n} from '@nhtio/adk/common'\nimport {\n  E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS,\n  E_WEBLLM_CHAT_COMPLETIONS_CONTEXT_OVERFLOW,\n  E_WEBLLM_CHAT_COMPLETIONS_STREAM_ERROR,\n  E_WEBLLM_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS,\n} from './exceptions'\nimport {\n  defaultDescriptionToChatCompletionsJsonSchema,\n  defaultRenderUntrustedContent,\n  defaultRenderTrustedContent,\n  defaultRenderStandingInstructions,\n  defaultRenderMemories,\n  defaultRenderRetrievables,\n  defaultRenderRetrievableSafetyDirective,\n  defaultRenderFirstPartyRetrievables,\n  defaultRenderThirdPartyPublicRetrievables,\n  defaultRenderThirdPartyPrivateRetrievables,\n  defaultRenderTimelineMessage,\n  defaultRenderThought,\n  defaultFilterThoughts,\n  defaultToolsToChatCompletionsTools,\n  defaultRenderChatCompletionsSystemPrompt,\n  defaultRenderChatCompletionsToolCallResult,\n  defaultBuildChatCompletionsHistory,\n  defaultCreateChatCompletionsToolCallDeltaAccumulator,\n} from './helpers'\nimport type { DispatchContext } from '@nhtio/adk/types'\nimport type { Tool, Memory, TokenEncoding } from '@nhtio/adk/common'\nimport type { DispatchExecutorFn, DispatchExecutorHelpers } from '@nhtio/adk/dispatch_runner'\nimport type {\n  WebLLMChatCompletionsAdapterOptions,\n  ChatCompletionsHelpers,\n  WebLLMChatCompletionsRequestBody,\n  ChatCompletionsChunk,\n  ChatCompletionsResponse,\n  AssembledToolCall,\n  ChatCompletionsContentBlock,\n  WebLLMEngine,\n} from './types'\n\n// ─── ADK-control keys (stripped before sending the request body) ──────────\n\nconst ADK_CONTROL_KEYS: ReadonlySet<string> = new Set([\n  'engine',\n  'createEngine',\n  'engineConfig',\n  'chatOptions',\n  'stream',\n  'bucketOrder',\n  'contextWindow',\n  'selfIdentity',\n  'thoughtSurfacing',\n  'tokenEncoding',\n  'replayCompatibility',\n  'helpers',\n  'strictToolChoice',\n  'unsupportedMediaPolicy',\n  'onInitProgress',\n  'isWebGPUAvailable',\n  'autoAck',\n])\n\n// ─── Option merging ───────────────────────────────────────────────────────────\n\nconst mergeHelpers = (\n  layers: ReadonlyArray<Partial<ChatCompletionsHelpers> | undefined>\n): Partial<ChatCompletionsHelpers> | undefined => {\n  let merged: Partial<ChatCompletionsHelpers> | undefined\n  for (const layer of layers) {\n    if (!layer) continue\n    merged = { ...(merged ?? {}), ...layer }\n  }\n  return merged\n}\n\nconst mergeOptions = (\n  baseline: WebLLMChatCompletionsAdapterOptions,\n  exec: Partial<WebLLMChatCompletionsAdapterOptions> | undefined,\n  stash: Partial<WebLLMChatCompletionsAdapterOptions> | undefined\n): Partial<WebLLMChatCompletionsAdapterOptions> => {\n  const layers = [baseline as Partial<WebLLMChatCompletionsAdapterOptions>, exec ?? {}, stash ?? {}]\n  const out: Record<string, unknown> = {}\n  for (const layer of layers) {\n    for (const [k, v] of Object.entries(layer)) {\n      if (v === undefined) continue\n      if (k === 'helpers') continue\n      out[k] = v\n    }\n  }\n  const helpers = mergeHelpers(layers.map((l) => l.helpers))\n  if (helpers !== undefined) out.helpers = helpers\n  return out as Partial<WebLLMChatCompletionsAdapterOptions>\n}\n\n// ─── Helper resolution ────────────────────────────────────────────────────────\n\nconst resolveHelpers = (\n  overrides: Partial<ChatCompletionsHelpers> | undefined\n): ChatCompletionsHelpers => {\n  const src = overrides ?? {}\n  return {\n    descriptionToChatCompletionsJsonSchema:\n      src.descriptionToChatCompletionsJsonSchema ?? defaultDescriptionToChatCompletionsJsonSchema,\n    renderUntrustedContent: src.renderUntrustedContent ?? defaultRenderUntrustedContent,\n    renderTrustedContent: src.renderTrustedContent ?? defaultRenderTrustedContent,\n    renderStandingInstructions: src.renderStandingInstructions ?? defaultRenderStandingInstructions,\n    renderMemories: src.renderMemories ?? defaultRenderMemories,\n    renderRetrievables: src.renderRetrievables ?? defaultRenderRetrievables,\n    renderRetrievableSafetyDirective:\n      src.renderRetrievableSafetyDirective ?? defaultRenderRetrievableSafetyDirective,\n    renderFirstPartyRetrievables:\n      src.renderFirstPartyRetrievables ?? defaultRenderFirstPartyRetrievables,\n    renderThirdPartyPublicRetrievables:\n      src.renderThirdPartyPublicRetrievables ?? defaultRenderThirdPartyPublicRetrievables,\n    renderThirdPartyPrivateRetrievables:\n      src.renderThirdPartyPrivateRetrievables ?? defaultRenderThirdPartyPrivateRetrievables,\n    renderTimelineMessage: src.renderTimelineMessage ?? defaultRenderTimelineMessage,\n    renderThought: src.renderThought ?? defaultRenderThought,\n    filterThoughts: src.filterThoughts ?? defaultFilterThoughts,\n    toolsToChatCompletionsTools:\n      src.toolsToChatCompletionsTools ?? defaultToolsToChatCompletionsTools,\n    renderChatCompletionsSystemPrompt:\n      src.renderChatCompletionsSystemPrompt ?? defaultRenderChatCompletionsSystemPrompt,\n    renderChatCompletionsToolCallResult:\n      src.renderChatCompletionsToolCallResult ?? defaultRenderChatCompletionsToolCallResult,\n    buildChatCompletionsHistory:\n      src.buildChatCompletionsHistory ?? defaultBuildChatCompletionsHistory,\n    createChatCompletionsToolCallDeltaAccumulator:\n      src.createChatCompletionsToolCallDeltaAccumulator ??\n      defaultCreateChatCompletionsToolCallDeltaAccumulator,\n  }\n}\n\n// ─── ID helpers ───────────────────────────────────────────────────────────────\n\n// Canonical (key-order-insensitive) checksum — MUST match the contract documented\n// on canonicalStringify and used by Tool.executor + dispatch_runner's streaming\n// helper, so ctx.toolCallCount(checksum) detects semantically-identical repeat\n// calls regardless of argument key order.\nconst computeChecksum = (tool: string, args: unknown): string =>\n  sha256(canonicalStringify({ tool, args }))\n\nconst nowIso = (): string => DateTime.now().toISO() ?? new Date().toISOString()\n\n// ─── Token measurement ────────────────────────────────────────────────────────\n\nconst estimateTokensOf = async (\n  value: { estimateTokens: (encoding: TokenEncoding) => number | Promise<number> },\n  encoding: TokenEncoding\n): Promise<number> => {\n  return Promise.resolve(value.estimateTokens(encoding))\n}\n\n// ─── Adapter class ────────────────────────────────────────────────────────────\n\n/**\n * Opinionated cross-environment LLM adapter for the WebLLM Chat Completions wire shape.\n *\n * @remarks\n * Construction validates options eagerly via {@link @nhtio/adk/batteries!validateOptions} and throws\n * {@link @nhtio/adk/batteries!E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS} on failure — config bugs fail loud, not at\n * dispatch time. The returned instance is reusable: call {@link WebLLMChatCompletionsAdapter.executor}\n * once per `DispatchRunner` configuration to obtain an {@link @nhtio/adk!DispatchExecutorFn} bound to the\n * baseline plus optional executor-scope overrides.\n *\n * Per-iteration overrides live on the active {@link @nhtio/adk!DispatchContext}'s\n * `stash.webLLMChatCompletions` slot and take highest precedence — they merge into the\n * executor-scope shape on every iteration. `helpers` merge key-by-key across all three layers;\n * every other field is replaced wholesale at the highest layer that\n * sets it.\n */\nexport class WebLLMChatCompletionsAdapter {\n  /**\n   * Customary key for per-iteration overrides on `ctx.stash`. The adapter reads\n   * `ctx.stash.get(WebLLMChatCompletionsAdapter.STASH_KEY, {})` at the start of every\n   * iteration and merges the value into the resolved options shape.\n   */\n  public static readonly STASH_KEY = 'webLLMChatCompletions' as const\n\n  readonly #baseline: WebLLMChatCompletionsAdapterOptions\n  #engine: WebLLMEngine | undefined\n  #enginePromise: Promise<WebLLMEngine> | undefined\n\n  public static isAvailable(): boolean {\n    return (\n      typeof globalThis.navigator !== 'undefined' &&\n      'gpu' in globalThis.navigator &&\n      typeof (globalThis.navigator as { gpu?: unknown }).gpu !== 'undefined'\n    )\n  }\n\n  /**\n   * @param options - Constructor-baseline options. Re-validated on every iteration after\n   *   per-dispatch and per-iteration overrides are layered in.\n   * @throws {@link @nhtio/adk/batteries!E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS} when `options` does not satisfy\n   *   {@link @nhtio/adk/batteries!webLLMChatCompletionsOptionsSchema}.\n   */\n  constructor(options: unknown) {\n    this.#baseline = validateOptions(options)\n    this.#engine = this.#baseline.engine\n  }\n\n  async preload(overrides?: Partial<WebLLMChatCompletionsAdapterOptions>): Promise<WebLLMEngine> {\n    const merged = validateOptions(mergeOptions(this.#baseline, overrides, undefined))\n    return this.#resolveEngine(merged)\n  }\n\n  reset(): void {\n    this.#engine = undefined\n    this.#enginePromise = undefined\n  }\n\n  isAvailable(): boolean {\n    return (this.#baseline.isWebGPUAvailable ?? WebLLMChatCompletionsAdapter.isAvailable)()\n  }\n\n  async #resolveEngine(merged: WebLLMChatCompletionsAdapterOptions): Promise<WebLLMEngine> {\n    if (merged.engine) {\n      this.#engine = merged.engine\n      return merged.engine\n    }\n    if (this.#engine) return this.#engine\n    const available = (merged.isWebGPUAvailable ?? WebLLMChatCompletionsAdapter.isAvailable)()\n    if (!available) {\n      throw new E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS([\n        'WebLLM requires a browser/runtime with WebGPU support',\n      ])\n    }\n    this.#enginePromise ??= (async () => {\n      const createEngine =\n        merged.createEngine ??\n        (async ({ model, engineConfig, chatOptions, onInitProgress }) => {\n          const { CreateMLCEngine } = await import('@mlc-ai/web-llm')\n          return (await CreateMLCEngine(\n            model,\n            { ...(engineConfig ?? {}), initProgressCallback: onInitProgress },\n            chatOptions\n          )) as WebLLMEngine\n        })\n      const engine = await createEngine({\n        model: merged.model,\n        engineConfig: merged.engineConfig,\n        chatOptions: merged.chatOptions,\n        onInitProgress: merged.onInitProgress,\n      })\n      this.#engine = engine\n      return engine\n    })()\n    return this.#enginePromise\n  }\n\n  /**\n   * Returns an {@link @nhtio/adk!DispatchExecutorFn} bound to this adapter's baseline plus optional\n   * executor-scope overrides. The returned function is reusable across iterations — every\n   * iteration re-merges with `ctx.stash[STASH_KEY]` and re-validates the result.\n   *\n   * @param overrides - Optional executor-scope overrides. Higher precedence than the baseline,\n   *   lower precedence than `ctx.stash[STASH_KEY]`.\n   * @returns An {@link @nhtio/adk!DispatchExecutorFn} suitable for `DispatchRunner`.\n   */\n  executor(overrides?: Partial<WebLLMChatCompletionsAdapterOptions>): DispatchExecutorFn {\n    const baseline = this.#baseline\n    const adapterClass = WebLLMChatCompletionsAdapter\n    return async (ctx: DispatchContext, helpers: DispatchExecutorHelpers): Promise<void> => {\n      // Bridge helpers.log → the legacy `warn: (msg) => void` slot exposed by the per-call\n      // helper signatures. Helpers downstream don't need to know the structured shape — they\n      // emit a single string, which we route to `helpers.log.warn` with a stable `kind` so\n      // observability middleware can still filter and aggregate.\n      const localWarn = (msg: string): void => {\n        helpers.log.warn({ kind: 'helper-warning', message: msg })\n      }\n\n      // ── Step 1: merge & validate ──────────────────────────────────────────\n      const stashRaw = ctx.stash.get(adapterClass.STASH_KEY, {}) as unknown\n      const stashOverrides =\n        stashRaw && typeof stashRaw === 'object'\n          ? (stashRaw as Partial<WebLLMChatCompletionsAdapterOptions>)\n          : {}\n      const mergedRaw = mergeOptions(baseline, overrides, stashOverrides)\n      const merged = validateOptions(mergedRaw)\n\n      // Cross-field invariant: tokenEncoding non-null requires contextWindow.\n      if (merged.tokenEncoding !== null && merged.contextWindow === undefined) {\n        throw new E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS([\n          'tokenEncoding is non-null but contextWindow is undefined',\n        ])\n      }\n\n      // ── Step 2: resolve helpers ───────────────────────────────────────────\n      const resolvedHelpers = resolveHelpers(merged.helpers)\n\n      // ── Step 3: forge artifact-query tools ────────────────────────────────\n      const uniqueCtors = new Set<typeof SpooledArtifact>()\n      for (const tc of ctx.turnToolCalls) {\n        const results = tc.results as unknown as { constructor?: unknown }\n        const ctor = results?.constructor\n        if (ctor && SpooledArtifact.isSpooledArtifactConstructor(ctor)) {\n          uniqueCtors.add(ctor as unknown as typeof SpooledArtifact)\n        }\n      }\n      const forgedRegistries: ToolRegistry[] = []\n      for (const ctor of uniqueCtors) {\n        const forgeFn = (\n          ctor as unknown as {\n            forgeTools?: (c: DispatchContext) => ToolRegistry\n          }\n        ).forgeTools\n        if (typeof forgeFn === 'function') {\n          forgedRegistries.push(forgeFn.call(ctor, ctx))\n        }\n      }\n      const mergedRegistry = ToolRegistry.merge([ctx.tools, ...forgedRegistries], {\n        onCollision: 'replace',\n      })\n      mergedRegistry.bindContext(ctx)\n\n      // ── Step 4: pre-render tool-call results ──────────────────────────────\n      const renderedToolCallResults = new Map<string, string | ChatCompletionsContentBlock[]>()\n      for (const tc of ctx.turnToolCalls) {\n        const rendered = await resolvedHelpers.renderChatCompletionsToolCallResult({\n          toolCall: tc,\n          results: tc.results as\n            | Tokenizable\n            | SpooledArtifact\n            | SpooledArtifact[]\n            | Media\n            | Media[],\n          tool: mergedRegistry.get(tc.tool) as Tool | ArtifactTool | undefined,\n          renderUntrustedContent: resolvedHelpers.renderUntrustedContent,\n          renderTrustedContent: resolvedHelpers.renderTrustedContent,\n          unsupportedMediaPolicy: merged.unsupportedMediaPolicy ?? 'throw',\n          warn: localWarn,\n        })\n        renderedToolCallResults.set(tc.id, rendered)\n      }\n\n      // ── Step 5: context window enforcement ────────────────────────────────\n      if (merged.tokenEncoding !== null && merged.contextWindow !== undefined) {\n        const encoding = merged.tokenEncoding as TokenEncoding\n        let spTokens = await estimateTokensOf(ctx.systemPrompt, encoding)\n        let siTokens = 0\n        for (const si of ctx.standingInstructions) {\n          siTokens += await estimateTokensOf(si, encoding)\n        }\n        let memTokens = 0\n        for (const mem of ctx.turnMemories as Set<Memory>) {\n          memTokens += await estimateTokensOf(mem.content, encoding)\n        }\n        let retTokens = 0\n        for (const r of ctx.turnRetrievables) {\n          retTokens += await estimateTokensOf(r.content, encoding)\n        }\n        let tlTokens = 0\n        for (const msg of ctx.turnMessages) {\n          if (msg.content !== undefined) {\n            tlTokens += await estimateTokensOf(msg.content, encoding)\n          }\n        }\n        for (const th of ctx.turnThoughts) {\n          tlTokens += await estimateTokensOf(th.content, encoding)\n        }\n        for (const rendered of renderedToolCallResults.values()) {\n          const textPart =\n            typeof rendered === 'string'\n              ? rendered\n              : rendered\n                  .filter((b): b is { type: 'text'; text: string } => b.type === 'text')\n                  .map((b) => b.text)\n                  .join('\\n')\n          const tk = new Tokenizable(textPart)\n          tlTokens += await estimateTokensOf(tk, encoding)\n        }\n        const total = spTokens + siTokens + memTokens + retTokens + tlTokens\n        const perBucketObj = {\n          systemPrompt: spTokens,\n          standingInstructions: siTokens,\n          memories: memTokens,\n          retrievables: retTokens,\n          timeline: tlTokens,\n        }\n        helpers.log.debug({\n          kind: 'context-window-usage',\n          message: `Context window usage: ${total}/${merged.contextWindow} tokens`,\n          payload: {\n            total,\n            limit: merged.contextWindow,\n            encoding,\n            perBucket: perBucketObj,\n          },\n        })\n        if (total > merged.contextWindow) {\n          const perBucket = JSON.stringify(perBucketObj)\n          throw new E_WEBLLM_CHAT_COMPLETIONS_CONTEXT_OVERFLOW([\n            total,\n            merged.contextWindow,\n            encoding,\n            perBucket,\n          ])\n        }\n      }\n\n      // ── Step 5b: tool_choice + forged artifact-tools guard ────────────────\n      // When `tool_choice` (or the `allowed_tools` variant) forces the model onto a specific\n      // tool name and that name resolves to an ephemeral, forged artifact-query tool, surface\n      // it as a structured warning (or throw under `strictToolChoice: true`). Forging an\n      // artifact-query tool by name is almost always a misconfiguration — the tool may not\n      // exist in the next iteration once the artifact ages out of `ctx.turnToolCalls`.\n      const forcedToolNames: string[] = []\n      const toolChoice = merged.tool_choice\n      let toolChoiceVariant: 'function' | 'allowed_tools' = 'function'\n      if (toolChoice && typeof toolChoice === 'object') {\n        if ('function' in toolChoice && toolChoice.type === 'function') {\n          forcedToolNames.push(toolChoice.function.name)\n        } else if ('custom' in toolChoice && toolChoice.type === 'custom') {\n          forcedToolNames.push(toolChoice.custom.name)\n        } else if (toolChoice.type === 'allowed_tools') {\n          toolChoiceVariant = 'allowed_tools'\n          for (const entry of toolChoice.allowed_tools.tools) {\n            if ('function' in entry) forcedToolNames.push(entry.function.name)\n            else if ('custom' in entry) forcedToolNames.push(entry.custom.name)\n          }\n        }\n      }\n      const forcedForgedHits: Array<{ toolName: string }> = []\n      for (const name of forcedToolNames) {\n        const t = mergedRegistry.get(name) as { ephemeral?: boolean } | undefined\n        if (t?.ephemeral === true) {\n          forcedForgedHits.push({ toolName: name })\n        }\n      }\n      if (forcedForgedHits.length > 0) {\n        if (merged.strictToolChoice === true) {\n          throw new E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS([\n            `tool_choice forces forged ephemeral artifact-query tool(s): ${forcedForgedHits\n              .map((h) => h.toolName)\n              .join(\n                ', '\n              )} — these may not exist on the next iteration. Remove the override or unset strictToolChoice.`,\n          ])\n        }\n        helpers.log.warn({\n          kind: 'tool-choice-forged-artifact',\n          message: `tool_choice forces ${forcedForgedHits.length} forged ephemeral artifact-query tool(s); this is almost always a misconfiguration`,\n          payload: {\n            toolNames: forcedForgedHits.map((h) => h.toolName),\n            variant: toolChoiceVariant,\n          },\n        })\n      }\n\n      // ── Step 6: build request body ────────────────────────────────────────\n      const { messages: wireMessages, reasoningPayloads } =\n        await resolvedHelpers.buildChatCompletionsHistory({\n          systemPrompt: ctx.systemPrompt,\n          standingInstructions: ctx.standingInstructions,\n          memories: ctx.turnMemories,\n          retrievables: ctx.turnRetrievables,\n          messages: ctx.turnMessages,\n          thoughts: ctx.turnThoughts,\n          toolCalls: ctx.turnToolCalls,\n          tools: mergedRegistry,\n          renderedToolCallResults,\n          bucketOrder: merged.bucketOrder ?? [\n            'standingInstructions',\n            'memories',\n            'retrievables',\n            'timeline',\n          ],\n          selfIdentity: merged.selfIdentity ?? 'assistant',\n          thoughtSurfacing: merged.thoughtSurfacing ?? 'all-self',\n          replayCompatibility: merged.replayCompatibility ?? [],\n          renderChatCompletionsToolCallResult: resolvedHelpers.renderChatCompletionsToolCallResult,\n          renderChatCompletionsSystemPrompt: resolvedHelpers.renderChatCompletionsSystemPrompt,\n          renderStandingInstructions: resolvedHelpers.renderStandingInstructions,\n          renderMemories: resolvedHelpers.renderMemories,\n          renderRetrievables: resolvedHelpers.renderRetrievables,\n          renderRetrievableSafetyDirective: resolvedHelpers.renderRetrievableSafetyDirective,\n          renderFirstPartyRetrievables: resolvedHelpers.renderFirstPartyRetrievables,\n          renderThirdPartyPublicRetrievables: resolvedHelpers.renderThirdPartyPublicRetrievables,\n          renderThirdPartyPrivateRetrievables: resolvedHelpers.renderThirdPartyPrivateRetrievables,\n          renderTimelineMessage: resolvedHelpers.renderTimelineMessage,\n          renderThought: resolvedHelpers.renderThought,\n          filterThoughts: resolvedHelpers.filterThoughts,\n          renderUntrustedContent: resolvedHelpers.renderUntrustedContent,\n          renderTrustedContent: resolvedHelpers.renderTrustedContent,\n          unsupportedMediaPolicy: merged.unsupportedMediaPolicy ?? 'throw',\n          warn: localWarn,\n        })\n\n      const stream = merged.stream ?? true\n      const body: WebLLMChatCompletionsRequestBody = {\n        model: merged.model,\n        messages: wireMessages,\n        stream,\n      }\n      for (const [k, v] of Object.entries(merged)) {\n        if (ADK_CONTROL_KEYS.has(k)) continue\n        if (k === 'model' || k === 'messages' || k === 'stream') continue\n        if (v === undefined) continue\n        ;(body as Record<string, unknown>)[k] = v\n      }\n      const toolsArr = mergedRegistry.all()\n      if (toolsArr.length > 0) {\n        body.tools = resolvedHelpers.toolsToChatCompletionsTools(toolsArr, {\n          descriptionToChatCompletionsJsonSchema:\n            resolvedHelpers.descriptionToChatCompletionsJsonSchema,\n        })\n      }\n      if (reasoningPayloads.length > 0) {\n        body._adk_reasoning_payloads = reasoningPayloads\n      }\n\n      // ── Step 7: invoke WebLLM engine ─────────────────────────────────────\n      let completion: ChatCompletionsResponse | AsyncIterable<ChatCompletionsChunk>\n      try {\n        const engine = await this.#resolveEngine(merged)\n        completion = (await engine.chat.completions.create(body as never)) as\n          | ChatCompletionsResponse\n          | AsyncIterable<ChatCompletionsChunk>\n      } catch (err) {\n        helpers.log.error({\n          kind: 'webllm-engine-error',\n          message: `WebLLM engine failure: ${isError(err) ? err.message : String(err)}`,\n          payload: { detail: isError(err) ? err.message : String(err) },\n        })\n        ctx.nack(\n          new E_WEBLLM_CHAT_COMPLETIONS_STREAM_ERROR([isError(err) ? err.message : String(err)])\n        )\n        return\n      }\n\n      // Spool store used to back string / Uint8Array tool returns. Bytes are written under the\n      // call id; the resulting SpooledArtifact (or tool-configured subclass) is the model-visible\n      // handle for the rest of the turn. Injectable via the `spoolStore` option so consumers can\n      // back artifacts with durable storage (OPFS, Flydrive); defaults to an ephemeral per-dispatch\n      // in-memory store. NOTE: an injected durable store persists across turns, so call ids must be\n      // globally unique for that store (see the `spoolStore` option docs).\n      const spoolStore = merged.spoolStore ?? new InMemorySpoolStore()\n\n      // ── Inner helper: persist + execute one assembled tool call ───────────\n      const executeAndPersistToolCall = async (call: AssembledToolCall): Promise<void> => {\n        const tool = mergedRegistry.get(call.name)\n        // Parse args defensively. The model may emit non-JSON or a non-object\n        // JSON value (string, number, array, null); both are recoverable error\n        // conditions, NOT dispatch-killers. A parse failure short-circuits to\n        // a persisted error ToolCall — formatted by `E_WEBLLM_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS`\n        // so consumers can match on the stable error code — letting the model\n        // self-correct on the next iteration.\n        let args: Record<string, unknown> = {}\n        let parseError:\n          | InstanceType<typeof E_WEBLLM_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS>\n          | undefined\n        if (call.args && call.args.length > 0) {\n          try {\n            const parsed: unknown = JSON.parse(call.args)\n            if (isObject(parsed)) {\n              args = parsed\n            } else {\n              const receivedKind = Array.isArray(parsed)\n                ? 'array'\n                : parsed === null\n                  ? 'null'\n                  : typeof parsed\n              parseError = new E_WEBLLM_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS([\n                `must be a JSON object; received ${receivedKind}`,\n                call.args,\n              ])\n            }\n          } catch {\n            parseError = new E_WEBLLM_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS([\n              'are not valid JSON',\n              call.args,\n            ])\n          }\n        }\n        const completedAt = nowIso()\n        if (parseError !== undefined) {\n          const results = new Tokenizable(parseError.message)\n          helpers.reportToolCall(call.id, { tool: call.name, args })\n          helpers.reportToolCall(call.id, {\n            results,\n            isError: true,\n            isComplete: true,\n          })\n          const checksum = computeChecksum(call.name, args)\n          await ctx.storeToolCall(\n            new ToolCall({\n              id: call.id,\n              tool: call.name,\n              args,\n              checksum,\n              isComplete: true,\n              isError: true,\n              results,\n              createdAt: completedAt,\n              updatedAt: completedAt,\n              completedAt,\n            })\n          )\n          return\n        }\n        if (!tool) {\n          const errText = `Tool not found: ${call.name}`\n          const results = new Tokenizable(errText)\n          helpers.reportToolCall(call.id, { tool: call.name, args })\n          helpers.reportToolCall(call.id, {\n            results,\n            isError: true,\n            isComplete: true,\n          })\n          const checksum = computeChecksum(call.name, args)\n          await ctx.storeToolCall(\n            new ToolCall({\n              id: call.id,\n              tool: call.name,\n              args,\n              checksum,\n              isComplete: true,\n              isError: true,\n              results,\n              createdAt: completedAt,\n              updatedAt: completedAt,\n              completedAt,\n            })\n          )\n          return\n        }\n        helpers.reportToolCall(call.id, { tool: tool.name, args })\n        const isArtifactTool = ArtifactTool.isArtifactTool(tool)\n        let results: Tokenizable | SpooledArtifact | SpooledArtifact[] | Media | Media[] =\n          new Tokenizable('')\n        let toolHadError = false\n        try {\n          const raw = await tool.executor(ctx)(args)\n          if (isArtifactTool) {\n            // ArtifactTool: handler returns a string | Tokenizable that *is* the model-visible\n            // answer to a query against a prior artifact. No spool write, no SpooledArtifact\n            // construction — pass through (or wrap a bare string in Tokenizable).\n            if (Tokenizable.isTokenizable(raw)) {\n              results = raw\n            } else if (typeof raw === 'string') {\n              results = new Tokenizable(raw)\n            } else {\n              throw new Error(\n                `ArtifactTool \"${tool.name}\" returned a non-string/non-Tokenizable value`\n              )\n            }\n          } else if (Media.isMedia(raw)) {\n            results = raw\n          } else if (Array.isArray(raw) && raw.length > 0 && raw.every((m) => Media.isMedia(m))) {\n            results = raw as Media[]\n          } else if (typeof raw === 'string' || isInstanceOf(raw, 'Uint8Array', Uint8Array)) {\n            const reader = await spoolStore.write(call.id, raw as string | Uint8Array)\n            const ArtifactCtor = (tool as Tool).artifactConstructor?.() ?? SpooledArtifact\n            results = new ArtifactCtor(reader)\n          } else {\n            // Defensive fallback — wrap stringified value so the model gets *something*.\n            const reader = await spoolStore.write(call.id, String(raw))\n            const ArtifactCtor = (tool as Tool).artifactConstructor?.() ?? SpooledArtifact\n            results = new ArtifactCtor(reader)\n          }\n        } catch (err) {\n          toolHadError = true\n          // Surface field-level validation detail from the cause chain so the\n          // model can self-correct on the specific offending field. `E_INVALID_TOOL_ARGS`\n          // carries the joi `ValidationException` on `cause`, whose message is the\n          // joined field-level error text (e.g. `\"text\" is required`).\n          let detailMsg = isError(err) ? err.message : String(err)\n          if (\n            isError(err) &&\n            isError(err.cause) &&\n            err.cause.message &&\n            err.cause.message !== err.message\n          ) {\n            detailMsg = `${detailMsg} ${err.cause.message}`\n          }\n          results = new Tokenizable(detailMsg)\n        }\n        helpers.reportToolCall(call.id, {\n          results,\n          isError: toolHadError,\n          isComplete: true,\n        })\n        const checksum = computeChecksum(tool.name, args)\n        const completedAt2 = nowIso()\n        await ctx.storeToolCall(\n          new ToolCall({\n            id: call.id,\n            tool: tool.name,\n            args,\n            checksum,\n            isComplete: true,\n            isError: toolHadError,\n            results,\n            fromArtifactTool: isArtifactTool,\n            createdAt: completedAt2,\n            updatedAt: completedAt2,\n            completedAt: completedAt2,\n          })\n        )\n      }\n\n      const selfIdentity = merged.selfIdentity ?? 'assistant'\n\n      // ── Step 8: streaming path ────────────────────────────────────────────\n      if (stream) {\n        const chunks = completion as AsyncIterable<ChatCompletionsChunk>\n        if (!chunks || typeof chunks[Symbol.asyncIterator] !== 'function') {\n          ctx.nack(new E_WEBLLM_CHAT_COMPLETIONS_STREAM_ERROR(['engine did not return a stream']))\n          return\n        }\n        const accumulator = resolvedHelpers.createChatCompletionsToolCallDeltaAccumulator()\n        const streamId = uuidv6()\n\n        let partialMessageContent = ''\n        let partialThoughtContent = ''\n        let sawMessageDelta = false\n        let sawThoughtDelta = false\n\n        const drainAndPersist = async (): Promise<void> => {\n          if (sawMessageDelta) {\n            helpers.reportMessage(streamId, '', { isComplete: true })\n            await ctx.storeMessage(\n              new Message({\n                id: streamId,\n                role: 'assistant',\n                content: partialMessageContent,\n                identity: selfIdentity,\n                createdAt: nowIso(),\n                updatedAt: nowIso(),\n              })\n            )\n          }\n          if (sawThoughtDelta) {\n            helpers.reportThought(streamId, '', { isComplete: true })\n            await ctx.storeThought(\n              new Thought({\n                id: streamId,\n                content: partialThoughtContent,\n                identity: selfIdentity,\n                createdAt: nowIso(),\n                updatedAt: nowIso(),\n              })\n            )\n          }\n          const calls = accumulator.drain()\n          helpers.log.debug({\n            kind: 'accumulator-finalised',\n            message: `Stream finalised: ${calls.length} tool call(s), message=${sawMessageDelta}, thought=${sawThoughtDelta}`,\n            payload: { toolCallCount: calls.length, sawMessageDelta, sawThoughtDelta },\n          })\n          if (calls.length === 0) {\n            // No tool calls — terminal text answer. Self-ack only when opted in;\n            // otherwise leave unsignalled so the implementor's output pipeline\n            // owns turn completion (autoAck defaults to false).\n            if (merged.autoAck) ctx.ack()\n            return\n          }\n          for (const call of calls) {\n            if (ctx.abortSignal.aborted) return\n            await executeAndPersistToolCall(call)\n          }\n          // Tool calls produced — do NOT ack; the runner will iterate again.\n        }\n\n        try {\n          for await (const chunk of chunks) {\n            if (ctx.abortSignal.aborted) return\n            const delta = chunk.choices?.[0]?.delta\n            if (!delta) continue\n            if (typeof delta.content === 'string' && delta.content.length > 0) {\n              sawMessageDelta = true\n              partialMessageContent += delta.content\n              helpers.reportMessage(streamId, delta.content)\n            }\n            const reasoning = (delta as { reasoning_content?: string | null }).reasoning_content\n            if (typeof reasoning === 'string' && reasoning.length > 0) {\n              sawThoughtDelta = true\n              partialThoughtContent += reasoning\n              helpers.reportThought(streamId, reasoning)\n            }\n            if (Array.isArray(delta.tool_calls)) {\n              for (const d of delta.tool_calls) {\n                accumulator.feed(d)\n              }\n            }\n          }\n          await drainAndPersist()\n        } catch (err) {\n          if (ctx.abortSignal.aborted) return\n          helpers.log.error({\n            kind: 'stream-error',\n            message: `WebLLM stream failed: ${isError(err) ? err.message : String(err)}`,\n            payload: { detail: isError(err) ? err.message : String(err) },\n          })\n          ctx.nack(\n            new E_WEBLLM_CHAT_COMPLETIONS_STREAM_ERROR([isError(err) ? err.message : String(err)])\n          )\n          return\n        }\n        return\n      }\n\n      // ── Step 9: non-streaming path ────────────────────────────────────────\n      const parsed = completion as ChatCompletionsResponse\n      const choice = parsed.choices?.[0]\n      if (!choice) {\n        // Empty response, no tool calls — terminal. Self-ack only when opted in.\n        if (merged.autoAck) ctx.ack()\n        return\n      }\n      const msg = choice.message\n      const responseId = parsed.id ?? uuidv6()\n\n      if (msg && typeof msg.content === 'string' && msg.content.length > 0) {\n        const messageId = `${responseId}:message`\n        helpers.reportMessage(messageId, msg.content, { isComplete: true })\n        await ctx.storeMessage(\n          new Message({\n            id: messageId,\n            role: 'assistant',\n            content: msg.content,\n            identity: selfIdentity,\n            createdAt: nowIso(),\n            updatedAt: nowIso(),\n          })\n        )\n      }\n      const reasoning = (msg as { reasoning_content?: string | null } | undefined)\n        ?.reasoning_content\n      if (typeof reasoning === 'string' && reasoning.length > 0) {\n        const thoughtId = `${responseId}:thought`\n        helpers.reportThought(thoughtId, reasoning, { isComplete: true })\n        await ctx.storeThought(\n          new Thought({\n            id: thoughtId,\n            content: reasoning,\n            identity: selfIdentity,\n            createdAt: nowIso(),\n            updatedAt: nowIso(),\n          })\n        )\n      }\n\n      const rawCalls = msg?.tool_calls ?? []\n      if (rawCalls.length === 0) {\n        // No tool calls — terminal text answer. Self-ack only when opted in;\n        // otherwise the implementor's output pipeline owns completion.\n        if (merged.autoAck) ctx.ack()\n        return\n      }\n      const calls: AssembledToolCall[] = rawCalls.map((tc) => ({\n        id: tc.id,\n        type: tc.type ?? 'function',\n        name: tc.function?.name ?? '',\n        args: tc.function?.arguments ?? '',\n      }))\n      for (const call of calls) {\n        if (ctx.abortSignal.aborted) return\n        await executeAndPersistToolCall(call)\n      }\n      // Tool calls produced — do NOT ack; the runner will iterate again.\n    }\n  }\n\n  /**\n   * Returns `true` when `value` is an {@link WebLLMChatCompletionsAdapter} instance.\n   *\n   * @param value - The value to test.\n   * @returns `true` when `value` is an `WebLLMChatCompletionsAdapter` instance.\n   */\n  public static isWebLLMChatCompletionsAdapter(\n    value: unknown\n  ): value is WebLLMChatCompletionsAdapter {\n    return isInstanceOf(value, 'WebLLMChatCompletionsAdapter', WebLLMChatCompletionsAdapter)\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"adapter.mjs","names":["#baseline","#engine","#resolveEngine","#enginePromise"],"sources":["../../../../src/batteries/llm/webllm_chat_completions/adapter.ts"],"sourcesContent":["/**\n * Cross-environment executor adapter for WebLLM Chat Completions compatible endpoints.\n *\n * @module @nhtio/adk/batteries/llm/webllm_chat_completions/adapter\n *\n * @remarks\n * Cross-environment LLM adapter for the WebLLM Chat Completions wire shape. Chat Completions was\n * chosen as the ADK's reference adapter because it is the de-facto interchange format for the\n * majority of OpenAI-compatible gateways (vLLM, Together, Groq, Fireworks, Ollama, Azure OpenAI,\n * OpenRouter, DeepSeek, Mistral La Plateforme, and most self-hosted deployments). Its tool-call\n * synthetic-history shape (`role: 'assistant', tool_calls: [...]` followed by `role: 'tool'` with\n * `tool_call_id`) is the lowest-common-denominator that every conformant gateway accepts.\n *\n * The adapter is built around three pluggable layers:\n *\n * 1. **Translation helpers** — the thirteen swappable functions exported from `./helpers` turn\n *    ADK primitives ({@link @nhtio/adk!Tokenizable}, {@link @nhtio/adk!Memory}, {@link @nhtio/adk!Message}, {@link @nhtio/adk!Thought},\n *    {@link @nhtio/adk!ToolCall}, {@link @nhtio/adk!Tool}, {@link @nhtio/adk!ArtifactTool}, {@link @nhtio/adk!SpooledArtifact}) into Chat\n *    Completions wire shapes. Consumers override individual helpers via `options.helpers.*` to\n *    customise envelope formats, bucket ordering, thought surfacing, or JSON Schema generation\n *    without forking the adapter.\n * 2. **Three-layer options merging** — constructor baseline, per-`executor()` overrides, and\n *    per-iteration `ctx.stash.webLLMChatCompletions` overrides combine with key-by-key\n *    precedence for `helpers` and wholesale replacement for everything else.\n *    The merged shape is re-validated on every iteration so a malformed stash override\n *    fails loud, not silently.\n * 3. **WebLLM engine invocation** — accepts a preloaded `engine` or lazy `createEngine` factory.\n *    The resolved request body is passed directly to WebLLM's OpenAI-compatible chat API.\n *\n * Per-iteration flow (steps 1–9 of the plan):\n * 1. Merge constructor / executor / stash options and re-validate.\n * 2. Resolve helpers, falling back to bundled `default*` for each unset field.\n * 3. Forge artifact-query tools by walking `ctx.turnToolCalls`, collecting unique\n *    `SpooledArtifact` constructors, calling `<Ctor>.forgeTools(ctx)` on each, and merging the\n *    results with `ctx.tools`.\n * 4. Pre-render every persisted tool-call result into the prompt-ready string the timeline will\n *    use, cached by `tc.id`.\n * 5. When `tokenEncoding !== null`, sum the token weight of every persisted bucket and throw\n *    {@link @nhtio/adk/batteries!E_WEBLLM_CHAT_COMPLETIONS_CONTEXT_OVERFLOW} when the total exceeds `contextWindow`.\n * 6. Build the request body via `buildChatCompletionsHistory`; carry vendor-opaque reasoning\n *    blocks through the `_adk_reasoning_payloads` side-channel.\n * 7. Resolve or lazily create a WebLLM engine and call `engine.chat.completions.create(body)`.\n * 8. Streaming path: consume WebLLM's async chunk iterable; surface deltas through\n *    `helpers.reportMessage` / `reportThought` / `reportToolCall`; assemble tool-call deltas via\n *    the accumulator; persist `Message` / `Thought` / `ToolCall` records on stream end.\n * 9. Non-streaming path: consume the returned Chat Completion object; same persistence +\n *    tool-execution loop.\n */\n\nimport { DateTime } from 'luxon'\nimport { sha256 } from 'js-sha256'\nimport { v6 as uuidv6 } from 'uuid'\nimport { validateOptions } from './validation'\nimport { isError, isInstanceOf, isObject } from '@nhtio/adk/guards'\nimport { canonicalStringify } from '../../../lib/utils/canonical_json'\nimport { InMemorySpoolStore } from '@nhtio/adk/batteries/storage/in_memory'\nimport {\n  Tokenizable,\n  ToolRegistry,\n  ToolCall,\n  Message,\n  Thought,\n  SpooledArtifact,\n  Media,\n  ArtifactTool,\n} from '@nhtio/adk/common'\nimport {\n  E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS,\n  E_WEBLLM_CHAT_COMPLETIONS_CONTEXT_OVERFLOW,\n  E_WEBLLM_CHAT_COMPLETIONS_STREAM_ERROR,\n  E_WEBLLM_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS,\n} from './exceptions'\nimport {\n  defaultDescriptionToChatCompletionsJsonSchema,\n  defaultRenderUntrustedContent,\n  defaultRenderTrustedContent,\n  defaultRenderStandingInstructions,\n  defaultRenderMemories,\n  defaultRenderRetrievables,\n  defaultRenderRetrievableSafetyDirective,\n  defaultRenderFirstPartyRetrievables,\n  defaultRenderThirdPartyPublicRetrievables,\n  defaultRenderThirdPartyPrivateRetrievables,\n  defaultRenderTimelineMessage,\n  defaultRenderThought,\n  defaultFilterThoughts,\n  defaultToolsToChatCompletionsTools,\n  defaultRenderChatCompletionsSystemPrompt,\n  defaultRenderChatCompletionsToolCallResult,\n  defaultBuildChatCompletionsHistory,\n  defaultCreateChatCompletionsToolCallDeltaAccumulator,\n} from './helpers'\nimport type { DispatchContext } from '@nhtio/adk/types'\nimport type { Tool, Memory, TokenEncoding } from '@nhtio/adk/common'\nimport type { DispatchExecutorFn, DispatchExecutorHelpers } from '@nhtio/adk/dispatch_runner'\nimport type {\n  WebLLMChatCompletionsAdapterOptions,\n  ChatCompletionsHelpers,\n  WebLLMChatCompletionsRequestBody,\n  ChatCompletionsChunk,\n  ChatCompletionsResponse,\n  AssembledToolCall,\n  ChatCompletionsContentBlock,\n  WebLLMEngine,\n} from './types'\n\n// ─── ADK-control keys (stripped before sending the request body) ──────────\n\nconst ADK_CONTROL_KEYS: ReadonlySet<string> = new Set([\n  'engine',\n  'createEngine',\n  'engineConfig',\n  'chatOptions',\n  'stream',\n  'bucketOrder',\n  'contextWindow',\n  'selfIdentity',\n  'thoughtSurfacing',\n  'tokenEncoding',\n  'replayCompatibility',\n  'helpers',\n  'strictToolChoice',\n  'unsupportedMediaPolicy',\n  'onInitProgress',\n  'isWebGPUAvailable',\n  'autoAck',\n])\n\n// ─── Option merging ───────────────────────────────────────────────────────────\n\nconst mergeHelpers = (\n  layers: ReadonlyArray<Partial<ChatCompletionsHelpers> | undefined>\n): Partial<ChatCompletionsHelpers> | undefined => {\n  let merged: Partial<ChatCompletionsHelpers> | undefined\n  for (const layer of layers) {\n    if (!layer) continue\n    merged = { ...(merged ?? {}), ...layer }\n  }\n  return merged\n}\n\nconst mergeOptions = (\n  baseline: WebLLMChatCompletionsAdapterOptions,\n  exec: Partial<WebLLMChatCompletionsAdapterOptions> | undefined,\n  stash: Partial<WebLLMChatCompletionsAdapterOptions> | undefined\n): Partial<WebLLMChatCompletionsAdapterOptions> => {\n  const layers = [baseline as Partial<WebLLMChatCompletionsAdapterOptions>, exec ?? {}, stash ?? {}]\n  const out: Record<string, unknown> = {}\n  for (const layer of layers) {\n    for (const [k, v] of Object.entries(layer)) {\n      if (v === undefined) continue\n      if (k === 'helpers') continue\n      out[k] = v\n    }\n  }\n  const helpers = mergeHelpers(layers.map((l) => l.helpers))\n  if (helpers !== undefined) out.helpers = helpers\n  return out as Partial<WebLLMChatCompletionsAdapterOptions>\n}\n\n// ─── Helper resolution ────────────────────────────────────────────────────────\n\nconst resolveHelpers = (\n  overrides: Partial<ChatCompletionsHelpers> | undefined\n): ChatCompletionsHelpers => {\n  const src = overrides ?? {}\n  return {\n    descriptionToChatCompletionsJsonSchema:\n      src.descriptionToChatCompletionsJsonSchema ?? defaultDescriptionToChatCompletionsJsonSchema,\n    renderUntrustedContent: src.renderUntrustedContent ?? defaultRenderUntrustedContent,\n    renderTrustedContent: src.renderTrustedContent ?? defaultRenderTrustedContent,\n    renderStandingInstructions: src.renderStandingInstructions ?? defaultRenderStandingInstructions,\n    renderMemories: src.renderMemories ?? defaultRenderMemories,\n    renderRetrievables: src.renderRetrievables ?? defaultRenderRetrievables,\n    renderRetrievableSafetyDirective:\n      src.renderRetrievableSafetyDirective ?? defaultRenderRetrievableSafetyDirective,\n    renderFirstPartyRetrievables:\n      src.renderFirstPartyRetrievables ?? defaultRenderFirstPartyRetrievables,\n    renderThirdPartyPublicRetrievables:\n      src.renderThirdPartyPublicRetrievables ?? defaultRenderThirdPartyPublicRetrievables,\n    renderThirdPartyPrivateRetrievables:\n      src.renderThirdPartyPrivateRetrievables ?? defaultRenderThirdPartyPrivateRetrievables,\n    renderTimelineMessage: src.renderTimelineMessage ?? defaultRenderTimelineMessage,\n    renderThought: src.renderThought ?? defaultRenderThought,\n    filterThoughts: src.filterThoughts ?? defaultFilterThoughts,\n    toolsToChatCompletionsTools:\n      src.toolsToChatCompletionsTools ?? defaultToolsToChatCompletionsTools,\n    renderChatCompletionsSystemPrompt:\n      src.renderChatCompletionsSystemPrompt ?? defaultRenderChatCompletionsSystemPrompt,\n    renderChatCompletionsToolCallResult:\n      src.renderChatCompletionsToolCallResult ?? defaultRenderChatCompletionsToolCallResult,\n    buildChatCompletionsHistory:\n      src.buildChatCompletionsHistory ?? defaultBuildChatCompletionsHistory,\n    createChatCompletionsToolCallDeltaAccumulator:\n      src.createChatCompletionsToolCallDeltaAccumulator ??\n      defaultCreateChatCompletionsToolCallDeltaAccumulator,\n  }\n}\n\n// ─── ID helpers ───────────────────────────────────────────────────────────────\n\n// Canonical (key-order-insensitive) checksum — MUST match the contract documented\n// on canonicalStringify and used by Tool.executor + dispatch_runner's streaming\n// helper, so ctx.toolCallCount(checksum) detects semantically-identical repeat\n// calls regardless of argument key order.\nconst computeChecksum = (tool: string, args: unknown): string =>\n  sha256(canonicalStringify({ tool, args }))\n\nconst nowIso = (): string => DateTime.now().toISO() ?? new Date().toISOString()\n\n// ─── Token measurement ────────────────────────────────────────────────────────\n\nconst estimateTokensOf = async (\n  value: { estimateTokens: (encoding: TokenEncoding) => number | Promise<number> },\n  encoding: TokenEncoding\n): Promise<number> => {\n  return Promise.resolve(value.estimateTokens(encoding))\n}\n\n// ─── Adapter class ────────────────────────────────────────────────────────────\n\n/**\n * Opinionated cross-environment LLM adapter for the WebLLM Chat Completions wire shape.\n *\n * @remarks\n * Construction validates options eagerly via {@link @nhtio/adk/batteries!validateOptions} and throws\n * {@link @nhtio/adk/batteries!E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS} on failure — config bugs fail loud, not at\n * dispatch time. The returned instance is reusable: call {@link WebLLMChatCompletionsAdapter.executor}\n * once per `DispatchRunner` configuration to obtain an {@link @nhtio/adk!DispatchExecutorFn} bound to the\n * baseline plus optional executor-scope overrides.\n *\n * Per-iteration overrides live on the active {@link @nhtio/adk!DispatchContext}'s\n * `stash.webLLMChatCompletions` slot and take highest precedence — they merge into the\n * executor-scope shape on every iteration. `helpers` merge key-by-key across all three layers;\n * every other field is replaced wholesale at the highest layer that\n * sets it.\n */\nexport class WebLLMChatCompletionsAdapter {\n  /**\n   * Customary key for per-iteration overrides on `ctx.stash`. The adapter reads\n   * `ctx.stash.get(WebLLMChatCompletionsAdapter.STASH_KEY, {})` at the start of every\n   * iteration and merges the value into the resolved options shape.\n   */\n  public static readonly STASH_KEY = 'webLLMChatCompletions' as const\n\n  readonly #baseline: WebLLMChatCompletionsAdapterOptions\n  #engine: WebLLMEngine | undefined\n  #enginePromise: Promise<WebLLMEngine> | undefined\n\n  public static isAvailable(): boolean {\n    return (\n      typeof globalThis.navigator !== 'undefined' &&\n      'gpu' in globalThis.navigator &&\n      typeof (globalThis.navigator as { gpu?: unknown }).gpu !== 'undefined'\n    )\n  }\n\n  /**\n   * @param options - Constructor-baseline options. Re-validated on every iteration after\n   *   per-dispatch and per-iteration overrides are layered in.\n   * @throws {@link @nhtio/adk/batteries!E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS} when `options` does not satisfy\n   *   {@link @nhtio/adk/batteries!webLLMChatCompletionsOptionsSchema}.\n   */\n  constructor(options: unknown) {\n    this.#baseline = validateOptions(options)\n    this.#engine = this.#baseline.engine\n  }\n\n  async preload(overrides?: Partial<WebLLMChatCompletionsAdapterOptions>): Promise<WebLLMEngine> {\n    const merged = validateOptions(mergeOptions(this.#baseline, overrides, undefined))\n    return this.#resolveEngine(merged)\n  }\n\n  reset(): void {\n    this.#engine = undefined\n    this.#enginePromise = undefined\n  }\n\n  isAvailable(): boolean {\n    return (this.#baseline.isWebGPUAvailable ?? WebLLMChatCompletionsAdapter.isAvailable)()\n  }\n\n  async #resolveEngine(merged: WebLLMChatCompletionsAdapterOptions): Promise<WebLLMEngine> {\n    if (merged.engine) {\n      this.#engine = merged.engine\n      return merged.engine\n    }\n    if (this.#engine) return this.#engine\n    const available = (merged.isWebGPUAvailable ?? WebLLMChatCompletionsAdapter.isAvailable)()\n    if (!available) {\n      throw new E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS([\n        'WebLLM requires a browser/runtime with WebGPU support',\n      ])\n    }\n    this.#enginePromise ??= (async () => {\n      const createEngine =\n        merged.createEngine ??\n        (async ({ model, engineConfig, chatOptions, onInitProgress }) => {\n          const { CreateMLCEngine } = await import('@mlc-ai/web-llm')\n          return (await CreateMLCEngine(\n            model,\n            { ...(engineConfig ?? {}), initProgressCallback: onInitProgress },\n            chatOptions\n          )) as WebLLMEngine\n        })\n      const engine = await createEngine({\n        model: merged.model,\n        engineConfig: merged.engineConfig,\n        chatOptions: merged.chatOptions,\n        onInitProgress: merged.onInitProgress,\n      })\n      this.#engine = engine\n      return engine\n    })()\n    return this.#enginePromise\n  }\n\n  /**\n   * Returns an {@link @nhtio/adk!DispatchExecutorFn} bound to this adapter's baseline plus optional\n   * executor-scope overrides. The returned function is reusable across iterations — every\n   * iteration re-merges with `ctx.stash[STASH_KEY]` and re-validates the result.\n   *\n   * @param overrides - Optional executor-scope overrides. Higher precedence than the baseline,\n   *   lower precedence than `ctx.stash[STASH_KEY]`.\n   * @returns An {@link @nhtio/adk!DispatchExecutorFn} suitable for `DispatchRunner`.\n   */\n  executor(overrides?: Partial<WebLLMChatCompletionsAdapterOptions>): DispatchExecutorFn {\n    const baseline = this.#baseline\n    const adapterClass = WebLLMChatCompletionsAdapter\n    return async (ctx: DispatchContext, helpers: DispatchExecutorHelpers): Promise<void> => {\n      // Bridge helpers.log → the legacy `warn: (msg) => void` slot exposed by the per-call\n      // helper signatures. Helpers downstream don't need to know the structured shape — they\n      // emit a single string, which we route to `helpers.log.warn` with a stable `kind` so\n      // observability middleware can still filter and aggregate.\n      const localWarn = (msg: string): void => {\n        helpers.log.warn({ kind: 'helper-warning', message: msg })\n      }\n\n      // ── Step 1: merge & validate ──────────────────────────────────────────\n      const stashRaw = ctx.stash.get(adapterClass.STASH_KEY, {}) as unknown\n      const stashOverrides =\n        stashRaw && typeof stashRaw === 'object'\n          ? (stashRaw as Partial<WebLLMChatCompletionsAdapterOptions>)\n          : {}\n      const mergedRaw = mergeOptions(baseline, overrides, stashOverrides)\n      const merged = validateOptions(mergedRaw)\n\n      // Cross-field invariant: tokenEncoding non-null requires contextWindow.\n      if (merged.tokenEncoding !== null && merged.contextWindow === undefined) {\n        throw new E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS([\n          'tokenEncoding is non-null but contextWindow is undefined',\n        ])\n      }\n\n      // ── Step 2: resolve helpers ───────────────────────────────────────────\n      const resolvedHelpers = resolveHelpers(merged.helpers)\n\n      // ── Step 3: forge artifact-query tools ────────────────────────────────\n      const uniqueCtors = new Set<typeof SpooledArtifact>()\n      for (const tc of ctx.turnToolCalls) {\n        const results = tc.results as unknown as { constructor?: unknown }\n        const ctor = results?.constructor\n        if (ctor && SpooledArtifact.isSpooledArtifactConstructor(ctor)) {\n          uniqueCtors.add(ctor as unknown as typeof SpooledArtifact)\n        }\n      }\n      const forgedRegistries: ToolRegistry[] = []\n      for (const ctor of uniqueCtors) {\n        const forgeFn = (\n          ctor as unknown as {\n            forgeTools?: (c: DispatchContext) => ToolRegistry\n          }\n        ).forgeTools\n        if (typeof forgeFn === 'function') {\n          forgedRegistries.push(forgeFn.call(ctor, ctx))\n        }\n      }\n      const mergedRegistry = ToolRegistry.merge([ctx.tools, ...forgedRegistries], {\n        onCollision: 'replace',\n      })\n      mergedRegistry.bindContext(ctx)\n\n      // ── Step 4: pre-render tool-call results ──────────────────────────────\n      const renderedToolCallResults = new Map<string, string | ChatCompletionsContentBlock[]>()\n      for (const tc of ctx.turnToolCalls) {\n        const rendered = await resolvedHelpers.renderChatCompletionsToolCallResult({\n          toolCall: tc,\n          results: tc.results as\n            | Tokenizable\n            | SpooledArtifact\n            | SpooledArtifact[]\n            | Media\n            | Media[],\n          tool: mergedRegistry.get(tc.tool) as Tool | ArtifactTool | undefined,\n          renderUntrustedContent: resolvedHelpers.renderUntrustedContent,\n          renderTrustedContent: resolvedHelpers.renderTrustedContent,\n          unsupportedMediaPolicy: merged.unsupportedMediaPolicy ?? 'throw',\n          warn: localWarn,\n        })\n        renderedToolCallResults.set(tc.id, rendered)\n      }\n\n      // ── Step 5: context window enforcement ────────────────────────────────\n      if (merged.tokenEncoding !== null && merged.contextWindow !== undefined) {\n        const encoding = merged.tokenEncoding as TokenEncoding\n        let spTokens = await estimateTokensOf(ctx.systemPrompt, encoding)\n        let siTokens = 0\n        for (const si of ctx.standingInstructions) {\n          siTokens += await estimateTokensOf(si, encoding)\n        }\n        let memTokens = 0\n        for (const mem of ctx.turnMemories as Set<Memory>) {\n          memTokens += await estimateTokensOf(mem.content, encoding)\n        }\n        let retTokens = 0\n        for (const r of ctx.turnRetrievables) {\n          retTokens += await estimateTokensOf(r.content, encoding)\n        }\n        let tlTokens = 0\n        for (const msg of ctx.turnMessages) {\n          if (msg.content !== undefined) {\n            tlTokens += await estimateTokensOf(msg.content, encoding)\n          }\n        }\n        for (const th of ctx.turnThoughts) {\n          tlTokens += await estimateTokensOf(th.content, encoding)\n        }\n        for (const rendered of renderedToolCallResults.values()) {\n          const textPart =\n            typeof rendered === 'string'\n              ? rendered\n              : rendered\n                  .filter((b): b is { type: 'text'; text: string } => b.type === 'text')\n                  .map((b) => b.text)\n                  .join('\\n')\n          const tk = new Tokenizable(textPart)\n          tlTokens += await estimateTokensOf(tk, encoding)\n        }\n        const total = spTokens + siTokens + memTokens + retTokens + tlTokens\n        const perBucketObj = {\n          systemPrompt: spTokens,\n          standingInstructions: siTokens,\n          memories: memTokens,\n          retrievables: retTokens,\n          timeline: tlTokens,\n        }\n        helpers.log.debug({\n          kind: 'context-window-usage',\n          message: `Context window usage: ${total}/${merged.contextWindow} tokens`,\n          payload: {\n            total,\n            limit: merged.contextWindow,\n            encoding,\n            perBucket: perBucketObj,\n          },\n        })\n        if (total > merged.contextWindow) {\n          const perBucket = JSON.stringify(perBucketObj)\n          throw new E_WEBLLM_CHAT_COMPLETIONS_CONTEXT_OVERFLOW([\n            total,\n            merged.contextWindow,\n            encoding,\n            perBucket,\n          ])\n        }\n      }\n\n      // ── Step 5b: tool_choice + forged artifact-tools guard ────────────────\n      // When `tool_choice` (or the `allowed_tools` variant) forces the model onto a specific\n      // tool name and that name resolves to an ephemeral, forged artifact-query tool, surface\n      // it as a structured warning (or throw under `strictToolChoice: true`). Forging an\n      // artifact-query tool by name is almost always a misconfiguration — the tool may not\n      // exist in the next iteration once the artifact ages out of `ctx.turnToolCalls`.\n      const forcedToolNames: string[] = []\n      const toolChoice = merged.tool_choice\n      let toolChoiceVariant: 'function' | 'allowed_tools' = 'function'\n      if (toolChoice && typeof toolChoice === 'object') {\n        if ('function' in toolChoice && toolChoice.type === 'function') {\n          forcedToolNames.push(toolChoice.function.name)\n        } else if ('custom' in toolChoice && toolChoice.type === 'custom') {\n          forcedToolNames.push(toolChoice.custom.name)\n        } else if (toolChoice.type === 'allowed_tools') {\n          toolChoiceVariant = 'allowed_tools'\n          for (const entry of toolChoice.allowed_tools.tools) {\n            if ('function' in entry) forcedToolNames.push(entry.function.name)\n            else if ('custom' in entry) forcedToolNames.push(entry.custom.name)\n          }\n        }\n      }\n      const forcedForgedHits: Array<{ toolName: string }> = []\n      for (const name of forcedToolNames) {\n        const t = mergedRegistry.get(name) as { ephemeral?: boolean } | undefined\n        if (t?.ephemeral === true) {\n          forcedForgedHits.push({ toolName: name })\n        }\n      }\n      if (forcedForgedHits.length > 0) {\n        if (merged.strictToolChoice === true) {\n          throw new E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS([\n            `tool_choice forces forged ephemeral artifact-query tool(s): ${forcedForgedHits\n              .map((h) => h.toolName)\n              .join(\n                ', '\n              )} — these may not exist on the next iteration. Remove the override or unset strictToolChoice.`,\n          ])\n        }\n        helpers.log.warn({\n          kind: 'tool-choice-forged-artifact',\n          message: `tool_choice forces ${forcedForgedHits.length} forged ephemeral artifact-query tool(s); this is almost always a misconfiguration`,\n          payload: {\n            toolNames: forcedForgedHits.map((h) => h.toolName),\n            variant: toolChoiceVariant,\n          },\n        })\n      }\n\n      // ── Step 6: build request body ────────────────────────────────────────\n      const { messages: wireMessages, reasoningPayloads } =\n        await resolvedHelpers.buildChatCompletionsHistory({\n          systemPrompt: ctx.systemPrompt,\n          standingInstructions: ctx.standingInstructions,\n          memories: ctx.turnMemories,\n          retrievables: ctx.turnRetrievables,\n          messages: ctx.turnMessages,\n          thoughts: ctx.turnThoughts,\n          toolCalls: ctx.turnToolCalls,\n          tools: mergedRegistry,\n          renderedToolCallResults,\n          bucketOrder: merged.bucketOrder ?? [\n            'standingInstructions',\n            'memories',\n            'retrievables',\n            'timeline',\n          ],\n          selfIdentity: merged.selfIdentity ?? 'assistant',\n          thoughtSurfacing: merged.thoughtSurfacing ?? 'all-self',\n          replayCompatibility: merged.replayCompatibility ?? [],\n          renderChatCompletionsToolCallResult: resolvedHelpers.renderChatCompletionsToolCallResult,\n          renderChatCompletionsSystemPrompt: resolvedHelpers.renderChatCompletionsSystemPrompt,\n          renderStandingInstructions: resolvedHelpers.renderStandingInstructions,\n          renderMemories: resolvedHelpers.renderMemories,\n          renderRetrievables: resolvedHelpers.renderRetrievables,\n          renderRetrievableSafetyDirective: resolvedHelpers.renderRetrievableSafetyDirective,\n          renderFirstPartyRetrievables: resolvedHelpers.renderFirstPartyRetrievables,\n          renderThirdPartyPublicRetrievables: resolvedHelpers.renderThirdPartyPublicRetrievables,\n          renderThirdPartyPrivateRetrievables: resolvedHelpers.renderThirdPartyPrivateRetrievables,\n          renderTimelineMessage: resolvedHelpers.renderTimelineMessage,\n          renderThought: resolvedHelpers.renderThought,\n          filterThoughts: resolvedHelpers.filterThoughts,\n          renderUntrustedContent: resolvedHelpers.renderUntrustedContent,\n          renderTrustedContent: resolvedHelpers.renderTrustedContent,\n          unsupportedMediaPolicy: merged.unsupportedMediaPolicy ?? 'throw',\n          warn: localWarn,\n        })\n\n      const stream = merged.stream ?? true\n      const body: WebLLMChatCompletionsRequestBody = {\n        model: merged.model,\n        messages: wireMessages,\n        stream,\n      }\n      for (const [k, v] of Object.entries(merged)) {\n        if (ADK_CONTROL_KEYS.has(k)) continue\n        if (k === 'model' || k === 'messages' || k === 'stream') continue\n        if (v === undefined) continue\n        ;(body as Record<string, unknown>)[k] = v\n      }\n      const toolsArr = mergedRegistry.all()\n      if (toolsArr.length > 0) {\n        body.tools = resolvedHelpers.toolsToChatCompletionsTools(toolsArr, {\n          descriptionToChatCompletionsJsonSchema:\n            resolvedHelpers.descriptionToChatCompletionsJsonSchema,\n        })\n      }\n      if (reasoningPayloads.length > 0) {\n        body._adk_reasoning_payloads = reasoningPayloads\n      }\n\n      // ── Step 7: invoke WebLLM engine ─────────────────────────────────────\n      let completion: ChatCompletionsResponse | AsyncIterable<ChatCompletionsChunk>\n      try {\n        const engine = await this.#resolveEngine(merged)\n        completion = (await engine.chat.completions.create(body as never)) as\n          | ChatCompletionsResponse\n          | AsyncIterable<ChatCompletionsChunk>\n      } catch (err) {\n        helpers.log.error({\n          kind: 'webllm-engine-error',\n          message: `WebLLM engine failure: ${isError(err) ? err.message : String(err)}`,\n          payload: { detail: isError(err) ? err.message : String(err) },\n        })\n        ctx.nack(\n          new E_WEBLLM_CHAT_COMPLETIONS_STREAM_ERROR([isError(err) ? err.message : String(err)])\n        )\n        return\n      }\n\n      // Spool store used to back string / Uint8Array tool returns. Bytes are written under the\n      // call id; the resulting SpooledArtifact (or tool-configured subclass) is the model-visible\n      // handle for the rest of the turn. Injectable via the `spoolStore` option so consumers can\n      // back artifacts with durable storage (OPFS, Flydrive); defaults to an ephemeral per-dispatch\n      // in-memory store. NOTE: an injected durable store persists across turns, so call ids must be\n      // globally unique for that store (see the `spoolStore` option docs).\n      const spoolStore = merged.spoolStore ?? new InMemorySpoolStore()\n\n      // ── Inner helper: persist + execute one assembled tool call ───────────\n      const executeAndPersistToolCall = async (call: AssembledToolCall): Promise<void> => {\n        const tool = mergedRegistry.get(call.name)\n        // Parse args defensively. The model may emit non-JSON or a non-object\n        // JSON value (string, number, array, null); both are recoverable error\n        // conditions, NOT dispatch-killers. A parse failure short-circuits to\n        // a persisted error ToolCall — formatted by `E_WEBLLM_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS`\n        // so consumers can match on the stable error code — letting the model\n        // self-correct on the next iteration.\n        let args: Record<string, unknown> = {}\n        let parseError:\n          | InstanceType<typeof E_WEBLLM_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS>\n          | undefined\n        if (call.args && call.args.length > 0) {\n          try {\n            const parsed: unknown = JSON.parse(call.args)\n            if (isObject(parsed)) {\n              args = parsed\n            } else {\n              const receivedKind = Array.isArray(parsed)\n                ? 'array'\n                : parsed === null\n                  ? 'null'\n                  : typeof parsed\n              parseError = new E_WEBLLM_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS([\n                `must be a JSON object; received ${receivedKind}`,\n                call.args,\n              ])\n            }\n          } catch {\n            parseError = new E_WEBLLM_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS([\n              'are not valid JSON',\n              call.args,\n            ])\n          }\n        }\n        const completedAt = nowIso()\n        if (parseError !== undefined) {\n          const results = new Tokenizable(parseError.message)\n          helpers.reportToolCall(call.id, { tool: call.name, args })\n          helpers.reportToolCall(call.id, {\n            results,\n            isError: true,\n            isComplete: true,\n          })\n          const checksum = computeChecksum(call.name, args)\n          await ctx.storeToolCall(\n            new ToolCall({\n              id: call.id,\n              tool: call.name,\n              args,\n              checksum,\n              isComplete: true,\n              isError: true,\n              results,\n              createdAt: completedAt,\n              updatedAt: completedAt,\n              completedAt,\n            })\n          )\n          return\n        }\n        if (!tool) {\n          // List the tools that DO exist so the model can self-correct on the next iteration\n          // instead of guessing. Without this, a single typo'd / hallucinated tool name yields\n          // a dead-end \"not found\" with no path forward.\n          const available = mergedRegistry\n            .all()\n            .map((t) => t.name)\n            .sort()\n          const errText =\n            available.length > 0\n              ? `Tool not found: ${call.name}. Available tools: ${available.join(', ')}.`\n              : `Tool not found: ${call.name}. No tools are available this turn.`\n          const results = new Tokenizable(errText)\n          helpers.reportToolCall(call.id, { tool: call.name, args })\n          helpers.reportToolCall(call.id, {\n            results,\n            isError: true,\n            isComplete: true,\n          })\n          const checksum = computeChecksum(call.name, args)\n          await ctx.storeToolCall(\n            new ToolCall({\n              id: call.id,\n              tool: call.name,\n              args,\n              checksum,\n              isComplete: true,\n              isError: true,\n              results,\n              createdAt: completedAt,\n              updatedAt: completedAt,\n              completedAt,\n            })\n          )\n          return\n        }\n        helpers.reportToolCall(call.id, { tool: tool.name, args })\n        const isArtifactTool = ArtifactTool.isArtifactTool(tool)\n        let results: Tokenizable | SpooledArtifact | SpooledArtifact[] | Media | Media[] =\n          new Tokenizable('')\n        let toolHadError = false\n        try {\n          const raw = await tool.executor(ctx)(args)\n          if (isArtifactTool) {\n            // ArtifactTool: handler returns a string | Tokenizable that *is* the model-visible\n            // answer to a query against a prior artifact. No spool write, no SpooledArtifact\n            // construction — pass through (or wrap a bare string in Tokenizable).\n            if (Tokenizable.isTokenizable(raw)) {\n              results = raw\n            } else if (typeof raw === 'string') {\n              results = new Tokenizable(raw)\n            } else {\n              throw new Error(\n                `ArtifactTool \"${tool.name}\" returned a non-string/non-Tokenizable value`\n              )\n            }\n          } else if (Media.isMedia(raw)) {\n            results = raw\n          } else if (Array.isArray(raw) && raw.length > 0 && raw.every((m) => Media.isMedia(m))) {\n            results = raw as Media[]\n          } else if (typeof raw === 'string' || isInstanceOf(raw, 'Uint8Array', Uint8Array)) {\n            const reader = await spoolStore.write(call.id, raw as string | Uint8Array)\n            const ArtifactCtor = (tool as Tool).artifactConstructor?.() ?? SpooledArtifact\n            results = new ArtifactCtor(reader)\n          } else {\n            // Defensive fallback — wrap stringified value so the model gets *something*.\n            const reader = await spoolStore.write(call.id, String(raw))\n            const ArtifactCtor = (tool as Tool).artifactConstructor?.() ?? SpooledArtifact\n            results = new ArtifactCtor(reader)\n          }\n        } catch (err) {\n          toolHadError = true\n          // Surface field-level validation detail from the cause chain so the\n          // model can self-correct on the specific offending field. `E_INVALID_TOOL_ARGS`\n          // carries the joi `ValidationException` on `cause`, whose message is the\n          // joined field-level error text (e.g. `\"text\" is required`).\n          let detailMsg = isError(err) ? err.message : String(err)\n          if (\n            isError(err) &&\n            isError(err.cause) &&\n            err.cause.message &&\n            err.cause.message !== err.message\n          ) {\n            detailMsg = `${detailMsg} ${err.cause.message}`\n          }\n          results = new Tokenizable(detailMsg)\n        }\n        helpers.reportToolCall(call.id, {\n          results,\n          isError: toolHadError,\n          isComplete: true,\n        })\n        const checksum = computeChecksum(tool.name, args)\n        const completedAt2 = nowIso()\n        await ctx.storeToolCall(\n          new ToolCall({\n            id: call.id,\n            tool: tool.name,\n            args,\n            checksum,\n            isComplete: true,\n            isError: toolHadError,\n            results,\n            fromArtifactTool: isArtifactTool,\n            createdAt: completedAt2,\n            updatedAt: completedAt2,\n            completedAt: completedAt2,\n          })\n        )\n      }\n\n      const selfIdentity = merged.selfIdentity ?? 'assistant'\n\n      // ── Step 8: streaming path ────────────────────────────────────────────\n      if (stream) {\n        const chunks = completion as AsyncIterable<ChatCompletionsChunk>\n        if (!chunks || typeof chunks[Symbol.asyncIterator] !== 'function') {\n          ctx.nack(new E_WEBLLM_CHAT_COMPLETIONS_STREAM_ERROR(['engine did not return a stream']))\n          return\n        }\n        const accumulator = resolvedHelpers.createChatCompletionsToolCallDeltaAccumulator()\n        const streamId = uuidv6()\n\n        let partialMessageContent = ''\n        let partialThoughtContent = ''\n        let sawMessageDelta = false\n        let sawThoughtDelta = false\n\n        const drainAndPersist = async (): Promise<void> => {\n          if (sawMessageDelta) {\n            helpers.reportMessage(streamId, '', { isComplete: true })\n            await ctx.storeMessage(\n              new Message({\n                id: streamId,\n                role: 'assistant',\n                content: partialMessageContent,\n                identity: selfIdentity,\n                createdAt: nowIso(),\n                updatedAt: nowIso(),\n              })\n            )\n          }\n          if (sawThoughtDelta) {\n            helpers.reportThought(streamId, '', { isComplete: true })\n            await ctx.storeThought(\n              new Thought({\n                id: streamId,\n                content: partialThoughtContent,\n                identity: selfIdentity,\n                createdAt: nowIso(),\n                updatedAt: nowIso(),\n              })\n            )\n          }\n          const calls = accumulator.drain()\n          helpers.log.debug({\n            kind: 'accumulator-finalised',\n            message: `Stream finalised: ${calls.length} tool call(s), message=${sawMessageDelta}, thought=${sawThoughtDelta}`,\n            payload: { toolCallCount: calls.length, sawMessageDelta, sawThoughtDelta },\n          })\n          if (calls.length === 0) {\n            // No tool calls — terminal text answer. Self-ack only when opted in;\n            // otherwise leave unsignalled so the implementor's output pipeline\n            // owns turn completion (autoAck defaults to false).\n            if (merged.autoAck) ctx.ack()\n            return\n          }\n          for (const call of calls) {\n            if (ctx.abortSignal.aborted) return\n            await executeAndPersistToolCall(call)\n          }\n          // Tool calls produced — do NOT ack; the runner will iterate again.\n        }\n\n        try {\n          for await (const chunk of chunks) {\n            if (ctx.abortSignal.aborted) return\n            const delta = chunk.choices?.[0]?.delta\n            if (!delta) continue\n            if (typeof delta.content === 'string' && delta.content.length > 0) {\n              sawMessageDelta = true\n              partialMessageContent += delta.content\n              helpers.reportMessage(streamId, delta.content)\n            }\n            const reasoning = (delta as { reasoning_content?: string | null }).reasoning_content\n            if (typeof reasoning === 'string' && reasoning.length > 0) {\n              sawThoughtDelta = true\n              partialThoughtContent += reasoning\n              helpers.reportThought(streamId, reasoning)\n            }\n            if (Array.isArray(delta.tool_calls)) {\n              for (const d of delta.tool_calls) {\n                accumulator.feed(d)\n              }\n            }\n          }\n          await drainAndPersist()\n        } catch (err) {\n          if (ctx.abortSignal.aborted) return\n          helpers.log.error({\n            kind: 'stream-error',\n            message: `WebLLM stream failed: ${isError(err) ? err.message : String(err)}`,\n            payload: { detail: isError(err) ? err.message : String(err) },\n          })\n          ctx.nack(\n            new E_WEBLLM_CHAT_COMPLETIONS_STREAM_ERROR([isError(err) ? err.message : String(err)])\n          )\n          return\n        }\n        return\n      }\n\n      // ── Step 9: non-streaming path ────────────────────────────────────────\n      const parsed = completion as ChatCompletionsResponse\n      const choice = parsed.choices?.[0]\n      if (!choice) {\n        // Empty response, no tool calls — terminal. Self-ack only when opted in.\n        if (merged.autoAck) ctx.ack()\n        return\n      }\n      const msg = choice.message\n      const responseId = parsed.id ?? uuidv6()\n\n      if (msg && typeof msg.content === 'string' && msg.content.length > 0) {\n        const messageId = `${responseId}:message`\n        helpers.reportMessage(messageId, msg.content, { isComplete: true })\n        await ctx.storeMessage(\n          new Message({\n            id: messageId,\n            role: 'assistant',\n            content: msg.content,\n            identity: selfIdentity,\n            createdAt: nowIso(),\n            updatedAt: nowIso(),\n          })\n        )\n      }\n      const reasoning = (msg as { reasoning_content?: string | null } | undefined)\n        ?.reasoning_content\n      if (typeof reasoning === 'string' && reasoning.length > 0) {\n        const thoughtId = `${responseId}:thought`\n        helpers.reportThought(thoughtId, reasoning, { isComplete: true })\n        await ctx.storeThought(\n          new Thought({\n            id: thoughtId,\n            content: reasoning,\n            identity: selfIdentity,\n            createdAt: nowIso(),\n            updatedAt: nowIso(),\n          })\n        )\n      }\n\n      const rawCalls = msg?.tool_calls ?? []\n      if (rawCalls.length === 0) {\n        // No tool calls — terminal text answer. Self-ack only when opted in;\n        // otherwise the implementor's output pipeline owns completion.\n        if (merged.autoAck) ctx.ack()\n        return\n      }\n      const calls: AssembledToolCall[] = rawCalls.map((tc) => ({\n        id: tc.id,\n        type: tc.type ?? 'function',\n        name: tc.function?.name ?? '',\n        args: tc.function?.arguments ?? '',\n      }))\n      for (const call of calls) {\n        if (ctx.abortSignal.aborted) return\n        await executeAndPersistToolCall(call)\n      }\n      // Tool calls produced — do NOT ack; the runner will iterate again.\n    }\n  }\n\n  /**\n   * Returns `true` when `value` is an {@link WebLLMChatCompletionsAdapter} instance.\n   *\n   * @param value - The value to test.\n   * @returns `true` when `value` is an `WebLLMChatCompletionsAdapter` instance.\n   */\n  public static isWebLLMChatCompletionsAdapter(\n    value: unknown\n  ): value is WebLLMChatCompletionsAdapter {\n    return isInstanceOf(value, 'WebLLMChatCompletionsAdapter', WebLLMChatCompletionsAdapter)\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4GA,IAAM,mBAAwC,IAAI,IAAI;CACpD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AAID,IAAM,gBACJ,WACgD;CAChD,IAAI;CACJ,KAAK,MAAM,SAAS,QAAQ;EAC1B,IAAI,CAAC,OAAO;EACZ,SAAS;GAAE,GAAI,UAAU,CAAC;GAAI,GAAG;EAAM;CACzC;CACA,OAAO;AACT;AAEA,IAAM,gBACJ,UACA,MACA,UACiD;CACjD,MAAM,SAAS;EAAC;EAA0D,QAAQ,CAAC;EAAG,SAAS,CAAC;CAAC;CACjG,MAAM,MAA+B,CAAC;CACtC,KAAK,MAAM,SAAS,QAClB,KAAK,MAAM,CAAC,GAAG,MAAM,OAAO,QAAQ,KAAK,GAAG;EAC1C,IAAI,MAAM,KAAA,GAAW;EACrB,IAAI,MAAM,WAAW;EACrB,IAAI,KAAK;CACX;CAEF,MAAM,UAAU,aAAa,OAAO,KAAK,MAAM,EAAE,OAAO,CAAC;CACzD,IAAI,YAAY,KAAA,GAAW,IAAI,UAAU;CACzC,OAAO;AACT;AAIA,IAAM,kBACJ,cAC2B;CAC3B,MAAM,MAAM,aAAa,CAAC;CAC1B,OAAO;EACL,wCACE,IAAI,0CAA0C;EAChD,wBAAwB,IAAI,0BAA0B;EACtD,sBAAsB,IAAI,wBAAwB;EAClD,4BAA4B,IAAI,8BAA8B;EAC9D,gBAAgB,IAAI,kBAAkB;EACtC,oBAAoB,IAAI,sBAAsB;EAC9C,kCACE,IAAI,oCAAoC;EAC1C,8BACE,IAAI,gCAAgC;EACtC,oCACE,IAAI,sCAAsC;EAC5C,qCACE,IAAI,uCAAuC;EAC7C,uBAAuB,IAAI,yBAAyB;EACpD,eAAe,IAAI,iBAAiB;EACpC,gBAAgB,IAAI,kBAAkB;EACtC,6BACE,IAAI,+BAA+B;EACrC,mCACE,IAAI,qCAAqC;EAC3C,qCACE,IAAI,uCAAuC;EAC7C,6BACE,IAAI,+BAA+B;EACrC,+CACE,IAAI,iDACJ;CACJ;AACF;AAQA,IAAM,mBAAmB,MAAc,SACrC,OAAO,mBAAmB;CAAE;CAAM;AAAK,CAAC,CAAC;AAE3C,IAAM,eAAuB,SAAS,IAAI,EAAE,MAAM,sBAAK,IAAI,KAAK,GAAE,YAAY;AAI9E,IAAM,mBAAmB,OACvB,OACA,aACoB;CACpB,OAAO,QAAQ,QAAQ,MAAM,eAAe,QAAQ,CAAC;AACvD;;;;;;;;;;;;;;;;;AAoBA,IAAa,+BAAb,MAAa,6BAA6B;;;;;;CAMxC,OAAuB,YAAY;CAEnC;CACA;CACA;CAEA,OAAc,cAAuB;EACnC,OACE,OAAO,WAAW,cAAc,eAChC,SAAS,WAAW,aACpB,OAAQ,WAAW,UAAgC,QAAQ;CAE/D;;;;;;;CAQA,YAAY,SAAkB;EAC5B,KAAKA,YAAY,gBAAgB,OAAO;EACxC,KAAKC,UAAU,KAAKD,UAAU;CAChC;CAEA,MAAM,QAAQ,WAAiF;EAC7F,MAAM,SAAS,gBAAgB,aAAa,KAAKA,WAAW,WAAW,KAAA,CAAS,CAAC;EACjF,OAAO,KAAKE,eAAe,MAAM;CACnC;CAEA,QAAc;EACZ,KAAKD,UAAU,KAAA;EACf,KAAKE,iBAAiB,KAAA;CACxB;CAEA,cAAuB;EACrB,QAAQ,KAAKH,UAAU,qBAAqB,6BAA6B,aAAa;CACxF;CAEA,MAAME,eAAe,QAAoE;EACvF,IAAI,OAAO,QAAQ;GACjB,KAAKD,UAAU,OAAO;GACtB,OAAO,OAAO;EAChB;EACA,IAAI,KAAKA,SAAS,OAAO,KAAKA;EAE9B,IAAI,EADe,OAAO,qBAAqB,6BAA6B,aACvE,GACH,MAAM,IAAI,0CAA0C,CAClD,uDACF,CAAC;EAEH,KAAKE,oBAAoB,YAAY;GAWnC,MAAM,SAAS,OATb,OAAO,iBACN,OAAO,EAAE,OAAO,cAAc,aAAa,qBAAqB;IAC/D,MAAM,EAAE,oBAAoB,MAAM,OAAO;IACzC,OAAQ,MAAM,gBACZ,OACA;KAAE,GAAI,gBAAgB,CAAC;KAAI,sBAAsB;IAAe,GAChE,WACF;GACF,IACgC;IAChC,OAAO,OAAO;IACd,cAAc,OAAO;IACrB,aAAa,OAAO;IACpB,gBAAgB,OAAO;GACzB,CAAC;GACD,KAAKF,UAAU;GACf,OAAO;EACT,GAAG;EACH,OAAO,KAAKE;CACd;;;;;;;;;;CAWA,SAAS,WAA8E;EACrF,MAAM,WAAW,KAAKH;EACtB,MAAM,eAAe;EACrB,OAAO,OAAO,KAAsB,YAAoD;GAKtF,MAAM,aAAa,QAAsB;IACvC,QAAQ,IAAI,KAAK;KAAE,MAAM;KAAkB,SAAS;IAAI,CAAC;GAC3D;GAGA,MAAM,WAAW,IAAI,MAAM,IAAI,aAAa,WAAW,CAAC,CAAC;GAMzD,MAAM,SAAS,gBADG,aAAa,UAAU,WAHvC,YAAY,OAAO,aAAa,WAC3B,WACD,CAAC,CAEwB,CAAS;GAGxC,IAAI,OAAO,kBAAkB,QAAQ,OAAO,kBAAkB,KAAA,GAC5D,MAAM,IAAI,0CAA0C,CAClD,0DACF,CAAC;GAIH,MAAM,kBAAkB,eAAe,OAAO,OAAO;GAGrD,MAAM,8BAAc,IAAI,IAA4B;GACpD,KAAK,MAAM,MAAM,IAAI,eAAe;IAElC,MAAM,OADU,GAAG,SACG;IACtB,IAAI,QAAQ,gBAAgB,6BAA6B,IAAI,GAC3D,YAAY,IAAI,IAAyC;GAE7D;GACA,MAAM,mBAAmC,CAAC;GAC1C,KAAK,MAAM,QAAQ,aAAa;IAC9B,MAAM,UACJ,KAGA;IACF,IAAI,OAAO,YAAY,YACrB,iBAAiB,KAAK,QAAQ,KAAK,MAAM,GAAG,CAAC;GAEjD;GACA,MAAM,iBAAiB,aAAa,MAAM,CAAC,IAAI,OAAO,GAAG,gBAAgB,GAAG,EAC1E,aAAa,UACf,CAAC;GACD,eAAe,YAAY,GAAG;GAG9B,MAAM,0CAA0B,IAAI,IAAoD;GACxF,KAAK,MAAM,MAAM,IAAI,eAAe;IAClC,MAAM,WAAW,MAAM,gBAAgB,oCAAoC;KACzE,UAAU;KACV,SAAS,GAAG;KAMZ,MAAM,eAAe,IAAI,GAAG,IAAI;KAChC,wBAAwB,gBAAgB;KACxC,sBAAsB,gBAAgB;KACtC,wBAAwB,OAAO,0BAA0B;KACzD,MAAM;IACR,CAAC;IACD,wBAAwB,IAAI,GAAG,IAAI,QAAQ;GAC7C;GAGA,IAAI,OAAO,kBAAkB,QAAQ,OAAO,kBAAkB,KAAA,GAAW;IACvE,MAAM,WAAW,OAAO;IACxB,IAAI,WAAW,MAAM,iBAAiB,IAAI,cAAc,QAAQ;IAChE,IAAI,WAAW;IACf,KAAK,MAAM,MAAM,IAAI,sBACnB,YAAY,MAAM,iBAAiB,IAAI,QAAQ;IAEjD,IAAI,YAAY;IAChB,KAAK,MAAM,OAAO,IAAI,cACpB,aAAa,MAAM,iBAAiB,IAAI,SAAS,QAAQ;IAE3D,IAAI,YAAY;IAChB,KAAK,MAAM,KAAK,IAAI,kBAClB,aAAa,MAAM,iBAAiB,EAAE,SAAS,QAAQ;IAEzD,IAAI,WAAW;IACf,KAAK,MAAM,OAAO,IAAI,cACpB,IAAI,IAAI,YAAY,KAAA,GAClB,YAAY,MAAM,iBAAiB,IAAI,SAAS,QAAQ;IAG5D,KAAK,MAAM,MAAM,IAAI,cACnB,YAAY,MAAM,iBAAiB,GAAG,SAAS,QAAQ;IAEzD,KAAK,MAAM,YAAY,wBAAwB,OAAO,GAAG;KAQvD,MAAM,KAAK,IAAI,YANb,OAAO,aAAa,WAChB,WACA,SACG,QAAQ,MAA2C,EAAE,SAAS,MAAM,EACpE,KAAK,MAAM,EAAE,IAAI,EACjB,KAAK,IAAI,CACiB;KACnC,YAAY,MAAM,iBAAiB,IAAI,QAAQ;IACjD;IACA,MAAM,QAAQ,WAAW,WAAW,YAAY,YAAY;IAC5D,MAAM,eAAe;KACnB,cAAc;KACd,sBAAsB;KACtB,UAAU;KACV,cAAc;KACd,UAAU;IACZ;IACA,QAAQ,IAAI,MAAM;KAChB,MAAM;KACN,SAAS,yBAAyB,MAAM,GAAG,OAAO,cAAc;KAChE,SAAS;MACP;MACA,OAAO,OAAO;MACd;MACA,WAAW;KACb;IACF,CAAC;IACD,IAAI,QAAQ,OAAO,eAAe;KAChC,MAAM,YAAY,KAAK,UAAU,YAAY;KAC7C,MAAM,IAAI,2CAA2C;MACnD;MACA,OAAO;MACP;MACA;KACF,CAAC;IACH;GACF;GAQA,MAAM,kBAA4B,CAAC;GACnC,MAAM,aAAa,OAAO;GAC1B,IAAI,oBAAkD;GACtD,IAAI,cAAc,OAAO,eAAe;QAClC,cAAc,cAAc,WAAW,SAAS,YAClD,gBAAgB,KAAK,WAAW,SAAS,IAAI;SACxC,IAAI,YAAY,cAAc,WAAW,SAAS,UACvD,gBAAgB,KAAK,WAAW,OAAO,IAAI;SACtC,IAAI,WAAW,SAAS,iBAAiB;KAC9C,oBAAoB;KACpB,KAAK,MAAM,SAAS,WAAW,cAAc,OAC3C,IAAI,cAAc,OAAO,gBAAgB,KAAK,MAAM,SAAS,IAAI;UAC5D,IAAI,YAAY,OAAO,gBAAgB,KAAK,MAAM,OAAO,IAAI;IAEtE;;GAEF,MAAM,mBAAgD,CAAC;GACvD,KAAK,MAAM,QAAQ,iBAEjB,IADU,eAAe,IAAI,IACzB,GAAG,cAAc,MACnB,iBAAiB,KAAK,EAAE,UAAU,KAAK,CAAC;GAG5C,IAAI,iBAAiB,SAAS,GAAG;IAC/B,IAAI,OAAO,qBAAqB,MAC9B,MAAM,IAAI,0CAA0C,CAClD,+DAA+D,iBAC5D,KAAK,MAAM,EAAE,QAAQ,EACrB,KACC,IACF,EAAE,6FACN,CAAC;IAEH,QAAQ,IAAI,KAAK;KACf,MAAM;KACN,SAAS,sBAAsB,iBAAiB,OAAO;KACvD,SAAS;MACP,WAAW,iBAAiB,KAAK,MAAM,EAAE,QAAQ;MACjD,SAAS;KACX;IACF,CAAC;GACH;GAGA,MAAM,EAAE,UAAU,cAAc,sBAC9B,MAAM,gBAAgB,4BAA4B;IAChD,cAAc,IAAI;IAClB,sBAAsB,IAAI;IAC1B,UAAU,IAAI;IACd,cAAc,IAAI;IAClB,UAAU,IAAI;IACd,UAAU,IAAI;IACd,WAAW,IAAI;IACf,OAAO;IACP;IACA,aAAa,OAAO,eAAe;KACjC;KACA;KACA;KACA;IACF;IACA,cAAc,OAAO,gBAAgB;IACrC,kBAAkB,OAAO,oBAAoB;IAC7C,qBAAqB,OAAO,uBAAuB,CAAC;IACpD,qCAAqC,gBAAgB;IACrD,mCAAmC,gBAAgB;IACnD,4BAA4B,gBAAgB;IAC5C,gBAAgB,gBAAgB;IAChC,oBAAoB,gBAAgB;IACpC,kCAAkC,gBAAgB;IAClD,8BAA8B,gBAAgB;IAC9C,oCAAoC,gBAAgB;IACpD,qCAAqC,gBAAgB;IACrD,uBAAuB,gBAAgB;IACvC,eAAe,gBAAgB;IAC/B,gBAAgB,gBAAgB;IAChC,wBAAwB,gBAAgB;IACxC,sBAAsB,gBAAgB;IACtC,wBAAwB,OAAO,0BAA0B;IACzD,MAAM;GACR,CAAC;GAEH,MAAM,SAAS,OAAO,UAAU;GAChC,MAAM,OAAyC;IAC7C,OAAO,OAAO;IACd,UAAU;IACV;GACF;GACA,KAAK,MAAM,CAAC,GAAG,MAAM,OAAO,QAAQ,MAAM,GAAG;IAC3C,IAAI,iBAAiB,IAAI,CAAC,GAAG;IAC7B,IAAI,MAAM,WAAW,MAAM,cAAc,MAAM,UAAU;IACzD,IAAI,MAAM,KAAA,GAAW;IACpB,KAAkC,KAAK;GAC1C;GACA,MAAM,WAAW,eAAe,IAAI;GACpC,IAAI,SAAS,SAAS,GACpB,KAAK,QAAQ,gBAAgB,4BAA4B,UAAU,EACjE,wCACE,gBAAgB,uCACpB,CAAC;GAEH,IAAI,kBAAkB,SAAS,GAC7B,KAAK,0BAA0B;GAIjC,IAAI;GACJ,IAAI;IAEF,aAAc,OAAM,MADC,KAAKE,eAAe,MAAM,GACpB,KAAK,YAAY,OAAO,IAAa;GAGlE,SAAS,KAAK;IACZ,QAAQ,IAAI,MAAM;KAChB,MAAM;KACN,SAAS,0BAA0B,QAAQ,GAAG,IAAI,IAAI,UAAU,OAAO,GAAG;KAC1E,SAAS,EAAE,QAAQ,QAAQ,GAAG,IAAI,IAAI,UAAU,OAAO,GAAG,EAAE;IAC9D,CAAC;IACD,IAAI,KACF,IAAI,uCAAuC,CAAC,QAAQ,GAAG,IAAI,IAAI,UAAU,OAAO,GAAG,CAAC,CAAC,CACvF;IACA;GACF;GAQA,MAAM,aAAa,OAAO,cAAc,IAAI,mBAAmB;GAG/D,MAAM,4BAA4B,OAAO,SAA2C;IAClF,MAAM,OAAO,eAAe,IAAI,KAAK,IAAI;IAOzC,IAAI,OAAgC,CAAC;IACrC,IAAI;IAGJ,IAAI,KAAK,QAAQ,KAAK,KAAK,SAAS,GAClC,IAAI;KACF,MAAM,SAAkB,KAAK,MAAM,KAAK,IAAI;KAC5C,IAAI,SAAS,MAAM,GACjB,OAAO;UAOP,aAAa,IAAI,iDAAiD,CAChE,mCANmB,MAAM,QAAQ,MAAM,IACrC,UACA,WAAW,OACT,SACA,OAAO,UAGX,KAAK,IACP,CAAC;IAEL,QAAQ;KACN,aAAa,IAAI,iDAAiD,CAChE,sBACA,KAAK,IACP,CAAC;IACH;IAEF,MAAM,cAAc,OAAO;IAC3B,IAAI,eAAe,KAAA,GAAW;KAC5B,MAAM,UAAU,IAAI,YAAY,WAAW,OAAO;KAClD,QAAQ,eAAe,KAAK,IAAI;MAAE,MAAM,KAAK;MAAM;KAAK,CAAC;KACzD,QAAQ,eAAe,KAAK,IAAI;MAC9B;MACA,SAAS;MACT,YAAY;KACd,CAAC;KACD,MAAM,WAAW,gBAAgB,KAAK,MAAM,IAAI;KAChD,MAAM,IAAI,cACR,IAAI,SAAS;MACX,IAAI,KAAK;MACT,MAAM,KAAK;MACX;MACA;MACA,YAAY;MACZ,SAAS;MACT;MACA,WAAW;MACX,WAAW;MACX;KACF,CAAC,CACH;KACA;IACF;IACA,IAAI,CAAC,MAAM;KAIT,MAAM,YAAY,eACf,IAAI,EACJ,KAAK,MAAM,EAAE,IAAI,EACjB,KAAK;KAKR,MAAM,UAAU,IAAI,YAHlB,UAAU,SAAS,IACf,mBAAmB,KAAK,KAAK,qBAAqB,UAAU,KAAK,IAAI,EAAE,KACvE,mBAAmB,KAAK,KAAK,oCACI;KACvC,QAAQ,eAAe,KAAK,IAAI;MAAE,MAAM,KAAK;MAAM;KAAK,CAAC;KACzD,QAAQ,eAAe,KAAK,IAAI;MAC9B;MACA,SAAS;MACT,YAAY;KACd,CAAC;KACD,MAAM,WAAW,gBAAgB,KAAK,MAAM,IAAI;KAChD,MAAM,IAAI,cACR,IAAI,SAAS;MACX,IAAI,KAAK;MACT,MAAM,KAAK;MACX;MACA;MACA,YAAY;MACZ,SAAS;MACT;MACA,WAAW;MACX,WAAW;MACX;KACF,CAAC,CACH;KACA;IACF;IACA,QAAQ,eAAe,KAAK,IAAI;KAAE,MAAM,KAAK;KAAM;IAAK,CAAC;IACzD,MAAM,iBAAiB,aAAa,eAAe,IAAI;IACvD,IAAI,UACF,IAAI,YAAY,EAAE;IACpB,IAAI,eAAe;IACnB,IAAI;KACF,MAAM,MAAM,MAAM,KAAK,SAAS,GAAG,EAAE,IAAI;KACzC,IAAI,gBAIF,IAAI,YAAY,cAAc,GAAG,GAC/B,UAAU;UACL,IAAI,OAAO,QAAQ,UACxB,UAAU,IAAI,YAAY,GAAG;UAE7B,MAAM,IAAI,MACR,iBAAiB,KAAK,KAAK,8CAC7B;UAEG,IAAI,MAAM,QAAQ,GAAG,GAC1B,UAAU;UACL,IAAI,MAAM,QAAQ,GAAG,KAAK,IAAI,SAAS,KAAK,IAAI,OAAO,MAAM,MAAM,QAAQ,CAAC,CAAC,GAClF,UAAU;UACL,IAAI,OAAO,QAAQ,YAAY,aAAa,KAAK,cAAc,UAAU,GAAG;MACjF,MAAM,SAAS,MAAM,WAAW,MAAM,KAAK,IAAI,GAA0B;MAEzE,UAAU,MADY,KAAc,sBAAsB,MAAK,iBACpC,MAAM;KACnC,OAAO;MAEL,MAAM,SAAS,MAAM,WAAW,MAAM,KAAK,IAAI,OAAO,GAAG,CAAC;MAE1D,UAAU,MADY,KAAc,sBAAsB,MAAK,iBACpC,MAAM;KACnC;IACF,SAAS,KAAK;KACZ,eAAe;KAKf,IAAI,YAAY,QAAQ,GAAG,IAAI,IAAI,UAAU,OAAO,GAAG;KACvD,IACE,QAAQ,GAAG,KACX,QAAQ,IAAI,KAAK,KACjB,IAAI,MAAM,WACV,IAAI,MAAM,YAAY,IAAI,SAE1B,YAAY,GAAG,UAAU,GAAG,IAAI,MAAM;KAExC,UAAU,IAAI,YAAY,SAAS;IACrC;IACA,QAAQ,eAAe,KAAK,IAAI;KAC9B;KACA,SAAS;KACT,YAAY;IACd,CAAC;IACD,MAAM,WAAW,gBAAgB,KAAK,MAAM,IAAI;IAChD,MAAM,eAAe,OAAO;IAC5B,MAAM,IAAI,cACR,IAAI,SAAS;KACX,IAAI,KAAK;KACT,MAAM,KAAK;KACX;KACA;KACA,YAAY;KACZ,SAAS;KACT;KACA,kBAAkB;KAClB,WAAW;KACX,WAAW;KACX,aAAa;IACf,CAAC,CACH;GACF;GAEA,MAAM,eAAe,OAAO,gBAAgB;GAG5C,IAAI,QAAQ;IACV,MAAM,SAAS;IACf,IAAI,CAAC,UAAU,OAAO,OAAO,OAAO,mBAAmB,YAAY;KACjE,IAAI,KAAK,IAAI,uCAAuC,CAAC,gCAAgC,CAAC,CAAC;KACvF;IACF;IACA,MAAM,cAAc,gBAAgB,8CAA8C;IAClF,MAAM,WAAW,GAAO;IAExB,IAAI,wBAAwB;IAC5B,IAAI,wBAAwB;IAC5B,IAAI,kBAAkB;IACtB,IAAI,kBAAkB;IAEtB,MAAM,kBAAkB,YAA2B;KACjD,IAAI,iBAAiB;MACnB,QAAQ,cAAc,UAAU,IAAI,EAAE,YAAY,KAAK,CAAC;MACxD,MAAM,IAAI,aACR,IAAI,QAAQ;OACV,IAAI;OACJ,MAAM;OACN,SAAS;OACT,UAAU;OACV,WAAW,OAAO;OAClB,WAAW,OAAO;MACpB,CAAC,CACH;KACF;KACA,IAAI,iBAAiB;MACnB,QAAQ,cAAc,UAAU,IAAI,EAAE,YAAY,KAAK,CAAC;MACxD,MAAM,IAAI,aACR,IAAI,QAAQ;OACV,IAAI;OACJ,SAAS;OACT,UAAU;OACV,WAAW,OAAO;OAClB,WAAW,OAAO;MACpB,CAAC,CACH;KACF;KACA,MAAM,QAAQ,YAAY,MAAM;KAChC,QAAQ,IAAI,MAAM;MAChB,MAAM;MACN,SAAS,qBAAqB,MAAM,OAAO,yBAAyB,gBAAgB,YAAY;MAChG,SAAS;OAAE,eAAe,MAAM;OAAQ;OAAiB;MAAgB;KAC3E,CAAC;KACD,IAAI,MAAM,WAAW,GAAG;MAItB,IAAI,OAAO,SAAS,IAAI,IAAI;MAC5B;KACF;KACA,KAAK,MAAM,QAAQ,OAAO;MACxB,IAAI,IAAI,YAAY,SAAS;MAC7B,MAAM,0BAA0B,IAAI;KACtC;IAEF;IAEA,IAAI;KACF,WAAW,MAAM,SAAS,QAAQ;MAChC,IAAI,IAAI,YAAY,SAAS;MAC7B,MAAM,QAAQ,MAAM,UAAU,IAAI;MAClC,IAAI,CAAC,OAAO;MACZ,IAAI,OAAO,MAAM,YAAY,YAAY,MAAM,QAAQ,SAAS,GAAG;OACjE,kBAAkB;OAClB,yBAAyB,MAAM;OAC/B,QAAQ,cAAc,UAAU,MAAM,OAAO;MAC/C;MACA,MAAM,YAAa,MAAgD;MACnE,IAAI,OAAO,cAAc,YAAY,UAAU,SAAS,GAAG;OACzD,kBAAkB;OAClB,yBAAyB;OACzB,QAAQ,cAAc,UAAU,SAAS;MAC3C;MACA,IAAI,MAAM,QAAQ,MAAM,UAAU,GAChC,KAAK,MAAM,KAAK,MAAM,YACpB,YAAY,KAAK,CAAC;KAGxB;KACA,MAAM,gBAAgB;IACxB,SAAS,KAAK;KACZ,IAAI,IAAI,YAAY,SAAS;KAC7B,QAAQ,IAAI,MAAM;MAChB,MAAM;MACN,SAAS,yBAAyB,QAAQ,GAAG,IAAI,IAAI,UAAU,OAAO,GAAG;MACzE,SAAS,EAAE,QAAQ,QAAQ,GAAG,IAAI,IAAI,UAAU,OAAO,GAAG,EAAE;KAC9D,CAAC;KACD,IAAI,KACF,IAAI,uCAAuC,CAAC,QAAQ,GAAG,IAAI,IAAI,UAAU,OAAO,GAAG,CAAC,CAAC,CACvF;KACA;IACF;IACA;GACF;GAGA,MAAM,SAAS;GACf,MAAM,SAAS,OAAO,UAAU;GAChC,IAAI,CAAC,QAAQ;IAEX,IAAI,OAAO,SAAS,IAAI,IAAI;IAC5B;GACF;GACA,MAAM,MAAM,OAAO;GACnB,MAAM,aAAa,OAAO,MAAM,GAAO;GAEvC,IAAI,OAAO,OAAO,IAAI,YAAY,YAAY,IAAI,QAAQ,SAAS,GAAG;IACpE,MAAM,YAAY,GAAG,WAAW;IAChC,QAAQ,cAAc,WAAW,IAAI,SAAS,EAAE,YAAY,KAAK,CAAC;IAClE,MAAM,IAAI,aACR,IAAI,QAAQ;KACV,IAAI;KACJ,MAAM;KACN,SAAS,IAAI;KACb,UAAU;KACV,WAAW,OAAO;KAClB,WAAW,OAAO;IACpB,CAAC,CACH;GACF;GACA,MAAM,YAAa,KACf;GACJ,IAAI,OAAO,cAAc,YAAY,UAAU,SAAS,GAAG;IACzD,MAAM,YAAY,GAAG,WAAW;IAChC,QAAQ,cAAc,WAAW,WAAW,EAAE,YAAY,KAAK,CAAC;IAChE,MAAM,IAAI,aACR,IAAI,QAAQ;KACV,IAAI;KACJ,SAAS;KACT,UAAU;KACV,WAAW,OAAO;KAClB,WAAW,OAAO;IACpB,CAAC,CACH;GACF;GAEA,MAAM,WAAW,KAAK,cAAc,CAAC;GACrC,IAAI,SAAS,WAAW,GAAG;IAGzB,IAAI,OAAO,SAAS,IAAI,IAAI;IAC5B;GACF;GACA,MAAM,QAA6B,SAAS,KAAK,QAAQ;IACvD,IAAI,GAAG;IACP,MAAM,GAAG,QAAQ;IACjB,MAAM,GAAG,UAAU,QAAQ;IAC3B,MAAM,GAAG,UAAU,aAAa;GAClC,EAAE;GACF,KAAK,MAAM,QAAQ,OAAO;IACxB,IAAI,IAAI,YAAY,SAAS;IAC7B,MAAM,0BAA0B,IAAI;GACtC;EAEF;CACF;;;;;;;CAQA,OAAc,+BACZ,OACuC;EACvC,OAAO,aAAa,OAAO,gCAAgC,4BAA4B;CACzF;AACF"}

package/batteries/llm/webllm_chat_completions/validation.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../../chunk-Ble4zEEl.js");
-const require_common = require("../../../common-DuKWGTVd.js");
+const require_common = require("../../../common-D_e5zYsG.js");
 require("../../../guards.cjs");
 const require_batteries_llm_webllm_chat_completions_exceptions = require("./exceptions.cjs");
 let _nhtio_validation = require("@nhtio/validation");

package/batteries/llm/webllm_chat_completions/validation.mjs

@@ -1,4 +1,4 @@
-import { i as byteStoreSchema } from "../../../common-ClCHam5-.mjs";
+import { i as byteStoreSchema } from "../../../common-lMrnzoyn.mjs";
 import "../../../guards.mjs";
 import { E_INVALID_WEBLLM_CHAT_COMPLETIONS_OPTIONS } from "./exceptions.mjs";
 import { validator } from "@nhtio/validation";

package/batteries/storage/flydrive.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_chunk = require("../../chunk-Ble4zEEl.js");
-const require_tool_registry = require("../../tool_registry-CKk5ooxm.js");
+const require_tool_registry = require("../../tool_registry-CtCQ4Xoz.js");
 require("../../guards.cjs");
 //#endregion
 //#region src/batteries/storage/flydrive/index.ts