@nhtio/adk 1.20260602.0 → 1.20260604.0

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

@@ -1 +1 @@
-{"version":3,"file":"validation.mjs","names":[],"sources":["../../../../src/batteries/llm/openai_chat_completions/validation.ts"],"sourcesContent":["/**\n * Runtime validation schema and wrapper for OpenAI Chat Completions adapter options.\n *\n * @module @nhtio/adk/batteries/llm/openai_chat_completions/validation\n *\n * @remarks\n * Schema and call-site wrapper for validating `OpenAIChatCompletionsAdapterOptions`. Used at\n * construction time and at the start of every iteration against the merged options shape\n * (stash > executor > constructor). Throws `E_INVALID_OPENAI_CHAT_COMPLETIONS_OPTIONS` on\n * failure — same hard-fail policy as every other ADK contract.\n */\n\nimport { isError } from '@nhtio/adk/guards'\nimport { byteStoreSchema } from '@nhtio/adk/common'\nimport { validator, ValidationError } from '@nhtio/validation'\nimport { E_INVALID_OPENAI_CHAT_COMPLETIONS_OPTIONS } from './exceptions'\nimport type { OpenAIChatCompletionsAdapterOptions } from './types'\n\n// ─── Sub-schemas ──────────────────────────────────────────────────────────────\n\nconst jsonSchemaSchema = validator.object().unknown(true)\n\nconst bucketLabelSchema = validator\n  .string()\n  .valid('standingInstructions', 'memories', 'retrievables', 'timeline')\n\nconst bucketOrderSchema = validator\n  .array()\n  .items(bucketLabelSchema)\n  .unique()\n  .default(['standingInstructions', 'memories', 'retrievables', 'timeline'])\n\nconst tokenEncodingSchema = validator\n  .alternatives(\n    validator\n      .string()\n      .valid(\n        'gpt2',\n        'r50k_base',\n        'p50k_base',\n        'p50k_edit',\n        'cl100k_base',\n        'o200k_base',\n        'gemini',\n        'llama2',\n        'claude'\n      ),\n    validator.any().valid(null)\n  )\n  .default(null)\n\nconst retrySchema = validator\n  .object({\n    maxAttempts: validator.number().integer().min(1).default(1),\n    baseDelayMs: validator.number().integer().min(0).default(500),\n    maxDelayMs: validator.number().integer().min(1).default(30_000),\n    retriableStatuses: validator\n      .array()\n      .items(validator.number().integer().min(100).max(599))\n      .default([429, 502, 503, 504]),\n    honorRetryAfter: validator.boolean().default(true),\n  })\n  .unknown(false)\n\nconst helperSchema = validator.function()\n\nconst helpersSchema = validator\n  .object({\n    descriptionToChatCompletionsJsonSchema: helperSchema.optional(),\n    renderUntrustedContent: helperSchema.optional(),\n    renderTrustedContent: helperSchema.optional(),\n    renderStandingInstructions: helperSchema.optional(),\n    renderMemories: helperSchema.optional(),\n    renderRetrievables: helperSchema.optional(),\n    renderRetrievableSafetyDirective: helperSchema.optional(),\n    renderFirstPartyRetrievables: helperSchema.optional(),\n    renderThirdPartyPublicRetrievables: helperSchema.optional(),\n    renderThirdPartyPrivateRetrievables: helperSchema.optional(),\n    renderTimelineMessage: helperSchema.optional(),\n    renderThought: helperSchema.optional(),\n    filterThoughts: helperSchema.optional(),\n    toolsToChatCompletionsTools: helperSchema.optional(),\n    renderChatCompletionsSystemPrompt: helperSchema.optional(),\n    renderChatCompletionsToolCallResult: helperSchema.optional(),\n    buildChatCompletionsHistory: helperSchema.optional(),\n    createChatCompletionsToolCallDeltaAccumulator: helperSchema.optional(),\n  })\n  .unknown(false)\n\n// ─── Chat Completions request-body sub-schemas ────────────────────────────────\n\nconst audioSchema = validator\n  .object({\n    voice: validator.string().required(),\n    format: validator.string().valid('wav', 'mp3', 'flac', 'opus', 'pcm16').required(),\n  })\n  .unknown(false)\n\nconst functionCallSchema = validator.alternatives(\n  validator.string().valid('none', 'auto'),\n  validator.object({ name: validator.string().required() }).unknown(false)\n)\n\nconst functionsItemSchema = validator\n  .object({\n    name: validator.string().required(),\n    description: validator.string().optional(),\n    parameters: jsonSchemaSchema.optional(),\n  })\n  .unknown(false)\n\nconst predictionSchema = validator\n  .object({\n    type: validator.string().valid('content').required(),\n    content: validator\n      .alternatives(\n        validator.string(),\n        validator.array().items(\n          validator\n            .object({\n              type: validator.string().valid('text').required(),\n              text: validator.string().required(),\n            })\n            .unknown(false)\n        )\n      )\n      .required(),\n  })\n  .unknown(false)\n\nconst responseFormatSchema = validator.alternatives(\n  validator.object({ type: validator.string().valid('text').required() }).unknown(false),\n  validator.object({ type: validator.string().valid('json_object').required() }).unknown(false),\n  validator\n    .object({\n      type: validator.string().valid('json_schema').required(),\n      json_schema: validator\n        .object({\n          name: validator.string().required(),\n          schema: jsonSchemaSchema.required(),\n          strict: validator.boolean().optional(),\n          description: validator.string().optional(),\n        })\n        .unknown(false)\n        .required(),\n    })\n    .unknown(false)\n)\n\nconst toolChoiceItemSchema = validator.alternatives(\n  validator\n    .object({\n      type: validator.string().valid('function').required(),\n      function: validator.object({ name: validator.string().required() }).unknown(false).required(),\n    })\n    .unknown(false),\n  validator\n    .object({\n      type: validator.string().valid('custom').required(),\n      custom: validator.object({ name: validator.string().required() }).unknown(false).required(),\n    })\n    .unknown(false)\n)\n\nconst toolChoiceSchema = validator.alternatives(\n  validator.string().valid('none', 'auto', 'required'),\n  toolChoiceItemSchema,\n  validator\n    .object({\n      type: validator.string().valid('allowed_tools').required(),\n      allowed_tools: validator\n        .object({\n          mode: validator.string().valid('auto', 'required').required(),\n          tools: validator.array().items(toolChoiceItemSchema).required(),\n        })\n        .unknown(false)\n        .required(),\n    })\n    .unknown(false)\n)\n\nconst streamOptionsSchema = validator\n  .object({\n    include_usage: validator.boolean().optional(),\n    include_obfuscation: validator.boolean().optional(),\n  })\n  .unknown(false)\n\nconst webSearchOptionsSchema = validator\n  .object({\n    search_context_size: validator.string().valid('low', 'medium', 'high').optional(),\n    user_location: validator\n      .object({\n        type: validator.string().valid('approximate').required(),\n        approximate: validator\n          .object({\n            city: validator.string().optional(),\n            country: validator.string().optional(),\n            region: validator.string().optional(),\n            timezone: validator.string().optional(),\n          })\n          .unknown(false)\n          .required(),\n      })\n      .unknown(false)\n      .optional(),\n  })\n  .unknown(false)\n\n// ─── Top-level schema ─────────────────────────────────────────────────────────\n\n/**\n * Validator schema for `OpenAIChatCompletionsAdapterOptions`.\n *\n * @remarks\n * Used by `validateOptions` at construction time and again at the start of every iteration after\n * options have been merged (stash > executor > constructor). Rejects unknown top-level keys\n * so typos and removed fields (`bucketBudgets`, `maxInlineToolResultFraction`, `trustedTools`)\n * fail loud.\n */\nexport const openAIChatCompletionsOptionsSchema = validator\n  .object<OpenAIChatCompletionsAdapterOptions>({\n    // ADK control\n    apiKey: validator.string().optional(),\n    baseURL: validator.string().optional(),\n    headers: validator.object().pattern(validator.string(), validator.string()).optional(),\n    stream: validator.boolean().default(true),\n    streamIdleTimeoutMs: validator.number().integer().min(0).default(0),\n    requestTimeoutMs: validator.number().integer().min(0).default(0),\n    retry: retrySchema.optional(),\n    fetch: validator.function().optional(),\n    bucketOrder: bucketOrderSchema,\n    contextWindow: validator.number().integer().min(1).optional(),\n    selfIdentity: validator.string().min(1).default('assistant'),\n    thoughtSurfacing: validator\n      .string()\n      .valid('all-self', 'latest-self', 'all')\n      .default('all-self'),\n    tokenEncoding: tokenEncodingSchema,\n    replayCompatibility: validator.array().items(validator.string().min(1)).default([]),\n    helpers: helpersSchema.optional(),\n    spoolStore: byteStoreSchema.optional(),\n    strictToolChoice: validator.boolean().default(false),\n    // Opt-in: the executor only self-acks tool-call-free responses when true.\n    // Default false hands turn-completion control to the implementor's output\n    // pipeline (see OpenAIChatCompletionsAdapterOptions.autoAck).\n    autoAck: validator.boolean().default(false),\n    unsupportedMediaPolicy: validator\n      .alternatives(\n        validator.string().valid('throw', 'fallback-stash', 'synthetic-description'),\n        validator\n          .object({\n            mode: validator.string().valid('fallback-stash').required(),\n            stashKeys: validator.array().items(validator.string().min(1)).required(),\n          })\n          .unknown(false)\n      )\n      .default('throw'),\n\n    // Chat Completions request body\n    model: validator.string().required(),\n    audio: audioSchema.optional(),\n    frequency_penalty: validator.number().min(-2).max(2).optional(),\n    function_call: functionCallSchema.optional(),\n    functions: validator.array().items(functionsItemSchema).optional(),\n    logit_bias: validator.object().pattern(validator.string(), validator.number()).optional(),\n    logprobs: validator.boolean().optional(),\n    max_completion_tokens: validator.number().integer().min(1).optional(),\n    max_tokens: validator.number().integer().min(1).optional(),\n    metadata: validator.object().pattern(validator.string(), validator.string()).optional(),\n    modalities: validator.array().items(validator.string().valid('text', 'audio')).optional(),\n    n: validator.number().integer().min(1).optional(),\n    parallel_tool_calls: validator.boolean().optional(),\n    prediction: predictionSchema.optional(),\n    presence_penalty: validator.number().min(-2).max(2).optional(),\n    prompt_cache_key: validator.string().optional(),\n    prompt_cache_retention: validator.string().valid('in_memory', '24h').optional(),\n    reasoning_effort: validator.string().valid('minimal', 'low', 'medium', 'high').optional(),\n    response_format: responseFormatSchema.optional(),\n    safety_identifier: validator.string().optional(),\n    seed: validator.number().integer().optional(),\n    service_tier: validator\n      .string()\n      .valid('auto', 'default', 'flex', 'priority', 'scale')\n      .optional(),\n    stop: validator\n      .alternatives(validator.string(), validator.array().items(validator.string()))\n      .optional(),\n    store: validator.boolean().optional(),\n    stream_options: streamOptionsSchema.optional(),\n    temperature: validator.number().min(0).max(2).optional(),\n    tool_choice: toolChoiceSchema.optional(),\n    top_logprobs: validator.number().integer().min(0).max(20).optional(),\n    top_p: validator.number().min(0).max(1).optional(),\n    user: validator.string().optional(),\n    verbosity: validator.string().valid('low', 'medium', 'high').optional(),\n    web_search_options: webSearchOptionsSchema.optional(),\n  })\n  .unknown(false)\n\nconst isValidationError = (value: unknown): value is ValidationError =>\n  isError(value) && Array.isArray((value as ValidationError).details)\n\nconst formatValidationDetails = (err: ValidationError): string =>\n  err.details.map((d) => d.message).join(' and ')\n\n/**\n * Validates an arbitrary input against `openAIChatCompletionsOptionsSchema` and returns the\n * resolved options shape. Throws `E_INVALID_OPENAI_CHAT_COMPLETIONS_OPTIONS` (carrying the\n * validator's error report on `cause`) on failure.\n *\n * @param input - The raw options object to validate.\n * @returns The resolved options object with defaults filled in.\n */\nexport const validateOptions = (input: unknown): OpenAIChatCompletionsAdapterOptions => {\n  const { value, error } = openAIChatCompletionsOptionsSchema.validate(input, {\n    abortEarly: false,\n    convert: false,\n  })\n  if (error) {\n    throw new E_INVALID_OPENAI_CHAT_COMPLETIONS_OPTIONS([formatValidationDetails(error)], {\n      cause: error,\n    })\n  }\n  return value as OpenAIChatCompletionsAdapterOptions\n}\n\n// suppress unused import warning when the alias isn't referenced\nvoid isValidationError\n"],"mappings":"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"}
+{"version":3,"file":"validation.mjs","names":[],"sources":["../../../../src/batteries/llm/openai_chat_completions/validation.ts"],"sourcesContent":["/**\n * Runtime validation schema and wrapper for OpenAI Chat Completions adapter options.\n *\n * @module @nhtio/adk/batteries/llm/openai_chat_completions/validation\n *\n * @remarks\n * Schema and call-site wrapper for validating `OpenAIChatCompletionsAdapterOptions`. Used at\n * construction time and at the start of every iteration against the merged options shape\n * (stash > executor > constructor). Throws `E_INVALID_OPENAI_CHAT_COMPLETIONS_OPTIONS` on\n * failure — same hard-fail policy as every other ADK contract.\n */\n\nimport { isError } from '@nhtio/adk/guards'\nimport { byteStoreSchema } from '@nhtio/adk/common'\nimport { validator, ValidationError } from '@nhtio/validation'\nimport { E_INVALID_OPENAI_CHAT_COMPLETIONS_OPTIONS } from './exceptions'\nimport type { OpenAIChatCompletionsAdapterOptions } from './types'\n\n// ─── Sub-schemas ──────────────────────────────────────────────────────────────\n\nconst jsonSchemaSchema = validator.object().unknown(true)\n\nconst bucketLabelSchema = validator\n  .string()\n  .valid('standingInstructions', 'memories', 'retrievables', 'timeline')\n\nconst bucketOrderSchema = validator\n  .array()\n  .items(bucketLabelSchema)\n  .unique()\n  .default(['standingInstructions', 'memories', 'retrievables', 'timeline'])\n\nconst reasoningFieldPrecedenceSchema = validator\n  .array()\n  .items(validator.string().valid('reasoning', 'reasoning_content'))\n  .unique()\n  .min(1)\n  .default(['reasoning', 'reasoning_content'])\n\nconst tokenEncodingSchema = validator\n  .alternatives(\n    validator\n      .string()\n      .valid(\n        'gpt2',\n        'r50k_base',\n        'p50k_base',\n        'p50k_edit',\n        'cl100k_base',\n        'o200k_base',\n        'gemini',\n        'llama2',\n        'claude'\n      ),\n    validator.any().valid(null)\n  )\n  .default(null)\n\nconst retrySchema = validator\n  .object({\n    maxAttempts: validator.number().integer().min(1).default(1),\n    baseDelayMs: validator.number().integer().min(0).default(500),\n    maxDelayMs: validator.number().integer().min(1).default(30_000),\n    retriableStatuses: validator\n      .array()\n      .items(validator.number().integer().min(100).max(599))\n      .default([429, 502, 503, 504]),\n    honorRetryAfter: validator.boolean().default(true),\n  })\n  .unknown(false)\n\nconst helperSchema = validator.function()\n\nconst helpersSchema = validator\n  .object({\n    descriptionToChatCompletionsJsonSchema: helperSchema.optional(),\n    renderUntrustedContent: helperSchema.optional(),\n    renderTrustedContent: helperSchema.optional(),\n    renderStandingInstructions: helperSchema.optional(),\n    renderMemories: helperSchema.optional(),\n    renderRetrievables: helperSchema.optional(),\n    renderRetrievableSafetyDirective: helperSchema.optional(),\n    renderFirstPartyRetrievables: helperSchema.optional(),\n    renderThirdPartyPublicRetrievables: helperSchema.optional(),\n    renderThirdPartyPrivateRetrievables: helperSchema.optional(),\n    renderTimelineMessage: helperSchema.optional(),\n    renderThought: helperSchema.optional(),\n    filterThoughts: helperSchema.optional(),\n    toolsToChatCompletionsTools: helperSchema.optional(),\n    renderChatCompletionsSystemPrompt: helperSchema.optional(),\n    renderChatCompletionsToolCallResult: helperSchema.optional(),\n    buildChatCompletionsHistory: helperSchema.optional(),\n    createChatCompletionsToolCallDeltaAccumulator: helperSchema.optional(),\n  })\n  .unknown(false)\n\n// ─── Chat Completions request-body sub-schemas ────────────────────────────────\n\nconst audioSchema = validator\n  .object({\n    voice: validator.string().required(),\n    format: validator.string().valid('wav', 'mp3', 'flac', 'opus', 'pcm16').required(),\n  })\n  .unknown(false)\n\nconst functionCallSchema = validator.alternatives(\n  validator.string().valid('none', 'auto'),\n  validator.object({ name: validator.string().required() }).unknown(false)\n)\n\nconst functionsItemSchema = validator\n  .object({\n    name: validator.string().required(),\n    description: validator.string().optional(),\n    parameters: jsonSchemaSchema.optional(),\n  })\n  .unknown(false)\n\nconst predictionSchema = validator\n  .object({\n    type: validator.string().valid('content').required(),\n    content: validator\n      .alternatives(\n        validator.string(),\n        validator.array().items(\n          validator\n            .object({\n              type: validator.string().valid('text').required(),\n              text: validator.string().required(),\n            })\n            .unknown(false)\n        )\n      )\n      .required(),\n  })\n  .unknown(false)\n\nconst responseFormatSchema = validator.alternatives(\n  validator.object({ type: validator.string().valid('text').required() }).unknown(false),\n  validator.object({ type: validator.string().valid('json_object').required() }).unknown(false),\n  validator\n    .object({\n      type: validator.string().valid('json_schema').required(),\n      json_schema: validator\n        .object({\n          name: validator.string().required(),\n          schema: jsonSchemaSchema.required(),\n          strict: validator.boolean().optional(),\n          description: validator.string().optional(),\n        })\n        .unknown(false)\n        .required(),\n    })\n    .unknown(false)\n)\n\nconst toolChoiceItemSchema = validator.alternatives(\n  validator\n    .object({\n      type: validator.string().valid('function').required(),\n      function: validator.object({ name: validator.string().required() }).unknown(false).required(),\n    })\n    .unknown(false),\n  validator\n    .object({\n      type: validator.string().valid('custom').required(),\n      custom: validator.object({ name: validator.string().required() }).unknown(false).required(),\n    })\n    .unknown(false)\n)\n\nconst toolChoiceSchema = validator.alternatives(\n  validator.string().valid('none', 'auto', 'required'),\n  toolChoiceItemSchema,\n  validator\n    .object({\n      type: validator.string().valid('allowed_tools').required(),\n      allowed_tools: validator\n        .object({\n          mode: validator.string().valid('auto', 'required').required(),\n          tools: validator.array().items(toolChoiceItemSchema).required(),\n        })\n        .unknown(false)\n        .required(),\n    })\n    .unknown(false)\n)\n\nconst streamOptionsSchema = validator\n  .object({\n    include_usage: validator.boolean().optional(),\n    include_obfuscation: validator.boolean().optional(),\n  })\n  .unknown(false)\n\nconst webSearchOptionsSchema = validator\n  .object({\n    search_context_size: validator.string().valid('low', 'medium', 'high').optional(),\n    user_location: validator\n      .object({\n        type: validator.string().valid('approximate').required(),\n        approximate: validator\n          .object({\n            city: validator.string().optional(),\n            country: validator.string().optional(),\n            region: validator.string().optional(),\n            timezone: validator.string().optional(),\n          })\n          .unknown(false)\n          .required(),\n      })\n      .unknown(false)\n      .optional(),\n  })\n  .unknown(false)\n\n// ─── Top-level schema ─────────────────────────────────────────────────────────\n\n/**\n * Validator schema for `OpenAIChatCompletionsAdapterOptions`.\n *\n * @remarks\n * Used by `validateOptions` at construction time and again at the start of every iteration after\n * options have been merged (stash > executor > constructor). Rejects unknown top-level keys\n * so typos and removed fields (`bucketBudgets`, `maxInlineToolResultFraction`, `trustedTools`)\n * fail loud.\n */\nexport const openAIChatCompletionsOptionsSchema = validator\n  .object<OpenAIChatCompletionsAdapterOptions>({\n    // ADK control\n    apiKey: validator.string().optional(),\n    baseURL: validator.string().optional(),\n    headers: validator.object().pattern(validator.string(), validator.string()).optional(),\n    stream: validator.boolean().default(true),\n    streamIdleTimeoutMs: validator.number().integer().min(0).default(0),\n    requestTimeoutMs: validator.number().integer().min(0).default(0),\n    retry: retrySchema.optional(),\n    fetch: validator.function().optional(),\n    bucketOrder: bucketOrderSchema,\n    contextWindow: validator.number().integer().min(1).optional(),\n    selfIdentity: validator.string().min(1).default('assistant'),\n    thoughtSurfacing: validator\n      .string()\n      .valid('all-self', 'latest-self', 'all')\n      .default('all-self'),\n    tokenEncoding: tokenEncodingSchema,\n    replayCompatibility: validator.array().items(validator.string().min(1)).default([]),\n    reasoningFieldPrecedence: reasoningFieldPrecedenceSchema,\n    helpers: helpersSchema.optional(),\n    spoolStore: byteStoreSchema.optional(),\n    strictToolChoice: validator.boolean().default(false),\n    // Opt-in: the executor only self-acks tool-call-free responses when true.\n    // Default false hands turn-completion control to the implementor's output\n    // pipeline (see OpenAIChatCompletionsAdapterOptions.autoAck).\n    autoAck: validator.boolean().default(false),\n    unsupportedMediaPolicy: validator\n      .alternatives(\n        validator.string().valid('throw', 'fallback-stash', 'synthetic-description'),\n        validator\n          .object({\n            mode: validator.string().valid('fallback-stash').required(),\n            stashKeys: validator.array().items(validator.string().min(1)).required(),\n          })\n          .unknown(false)\n      )\n      .default('throw'),\n\n    // Chat Completions request body\n    model: validator.string().required(),\n    audio: audioSchema.optional(),\n    frequency_penalty: validator.number().min(-2).max(2).optional(),\n    function_call: functionCallSchema.optional(),\n    functions: validator.array().items(functionsItemSchema).optional(),\n    logit_bias: validator.object().pattern(validator.string(), validator.number()).optional(),\n    logprobs: validator.boolean().optional(),\n    max_completion_tokens: validator.number().integer().min(1).optional(),\n    max_tokens: validator.number().integer().min(1).optional(),\n    metadata: validator.object().pattern(validator.string(), validator.string()).optional(),\n    modalities: validator.array().items(validator.string().valid('text', 'audio')).optional(),\n    n: validator.number().integer().min(1).optional(),\n    parallel_tool_calls: validator.boolean().optional(),\n    prediction: predictionSchema.optional(),\n    presence_penalty: validator.number().min(-2).max(2).optional(),\n    prompt_cache_key: validator.string().optional(),\n    prompt_cache_retention: validator.string().valid('in_memory', '24h').optional(),\n    reasoning_effort: validator.string().valid('minimal', 'low', 'medium', 'high').optional(),\n    response_format: responseFormatSchema.optional(),\n    safety_identifier: validator.string().optional(),\n    seed: validator.number().integer().optional(),\n    service_tier: validator\n      .string()\n      .valid('auto', 'default', 'flex', 'priority', 'scale')\n      .optional(),\n    stop: validator\n      .alternatives(validator.string(), validator.array().items(validator.string()))\n      .optional(),\n    store: validator.boolean().optional(),\n    stream_options: streamOptionsSchema.optional(),\n    temperature: validator.number().min(0).max(2).optional(),\n    tool_choice: toolChoiceSchema.optional(),\n    top_logprobs: validator.number().integer().min(0).max(20).optional(),\n    top_p: validator.number().min(0).max(1).optional(),\n    user: validator.string().optional(),\n    verbosity: validator.string().valid('low', 'medium', 'high').optional(),\n    web_search_options: webSearchOptionsSchema.optional(),\n  })\n  .unknown(false)\n\nconst isValidationError = (value: unknown): value is ValidationError =>\n  isError(value) && Array.isArray((value as ValidationError).details)\n\nconst formatValidationDetails = (err: ValidationError): string =>\n  err.details.map((d) => d.message).join(' and ')\n\n/**\n * Validates an arbitrary input against `openAIChatCompletionsOptionsSchema` and returns the\n * resolved options shape. Throws `E_INVALID_OPENAI_CHAT_COMPLETIONS_OPTIONS` (carrying the\n * validator's error report on `cause`) on failure.\n *\n * @param input - The raw options object to validate.\n * @returns The resolved options object with defaults filled in.\n */\nexport const validateOptions = (input: unknown): OpenAIChatCompletionsAdapterOptions => {\n  const { value, error } = openAIChatCompletionsOptionsSchema.validate(input, {\n    abortEarly: false,\n    convert: false,\n  })\n  if (error) {\n    throw new E_INVALID_OPENAI_CHAT_COMPLETIONS_OPTIONS([formatValidationDetails(error)], {\n      cause: error,\n    })\n  }\n  return value as OpenAIChatCompletionsAdapterOptions\n}\n\n// suppress unused import warning when the alias isn't referenced\nvoid isValidationError\n"],"mappings":"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"}

package/batteries/llm/openai_chat_completions.cjs

@@ -33,6 +33,7 @@ exports.defaultRenderTrustedContent = require_batteries_llm_openai_chat_completi
 exports.defaultRenderUntrustedContent = require_batteries_llm_openai_chat_completions_helpers.defaultRenderUntrustedContent;
 exports.defaultToolsToChatCompletionsTools = require_batteries_llm_openai_chat_completions_helpers.defaultToolsToChatCompletionsTools;
 exports.descriptionToChatCompletionsJsonSchema = require_batteries_llm_openai_chat_completions_helpers.descriptionToChatCompletionsJsonSchema;
+exports.extractReasoningFields = require_batteries_llm_openai_chat_completions_helpers.extractReasoningFields;
 exports.filterThoughts = require_batteries_llm_openai_chat_completions_helpers.filterThoughts;
 exports.openAIChatCompletionsOptionsSchema = require_batteries_llm_openai_chat_completions_validation.openAIChatCompletionsOptionsSchema;
 exports.renderChatCompletionsSystemPrompt = require_batteries_llm_openai_chat_completions_helpers.renderChatCompletionsSystemPrompt;

package/batteries/llm/openai_chat_completions.mjs

@@ -1,5 +1,5 @@
 import { E_INVALID_OPENAI_CHAT_COMPLETIONS_OPTIONS, E_OPENAI_CHAT_COMPLETIONS_CONTEXT_OVERFLOW, E_OPENAI_CHAT_COMPLETIONS_HTTP_ERROR, E_OPENAI_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS, E_OPENAI_CHAT_COMPLETIONS_REQUEST_TIMEOUT, E_OPENAI_CHAT_COMPLETIONS_STREAM_ERROR, E_OPENAI_CHAT_COMPLETIONS_STREAM_STALLED } from "./openai_chat_completions/exceptions.mjs";
 import { openAIChatCompletionsOptionsSchema, validateOptions } from "./openai_chat_completions/validation.mjs";
-import { buildChatCompletionsHistory, createChatCompletionsToolCallDeltaAccumulator, defaultBuildChatCompletionsHistory, defaultCreateChatCompletionsToolCallDeltaAccumulator, defaultDescriptionToChatCompletionsJsonSchema, defaultFilterThoughts, defaultRenderChatCompletionsSystemPrompt, defaultRenderChatCompletionsToolCallResult, defaultRenderFirstPartyRetrievables, defaultRenderMemories, defaultRenderRetrievableSafetyDirective, defaultRenderRetrievables, defaultRenderStandingInstructions, defaultRenderThirdPartyPrivateRetrievables, defaultRenderThirdPartyPublicRetrievables, defaultRenderThought, defaultRenderTimelineMessage, defaultRenderTrustedContent, defaultRenderUntrustedContent, defaultToolsToChatCompletionsTools, descriptionToChatCompletionsJsonSchema, filterThoughts, renderChatCompletionsSystemPrompt, renderChatCompletionsToolCallResult, renderFirstPartyRetrievables, renderMemories, renderRetrievableSafetyDirective, renderRetrievables, renderStandingInstructions, renderThirdPartyPrivateRetrievables, renderThirdPartyPublicRetrievables, renderThought, renderTimelineMessage, renderTrustedContent, renderUntrustedContent, toolsToChatCompletionsTools } from "./openai_chat_completions/helpers.mjs";
+import { buildChatCompletionsHistory, createChatCompletionsToolCallDeltaAccumulator, defaultBuildChatCompletionsHistory, defaultCreateChatCompletionsToolCallDeltaAccumulator, defaultDescriptionToChatCompletionsJsonSchema, defaultFilterThoughts, defaultRenderChatCompletionsSystemPrompt, defaultRenderChatCompletionsToolCallResult, defaultRenderFirstPartyRetrievables, defaultRenderMemories, defaultRenderRetrievableSafetyDirective, defaultRenderRetrievables, defaultRenderStandingInstructions, defaultRenderThirdPartyPrivateRetrievables, defaultRenderThirdPartyPublicRetrievables, defaultRenderThought, defaultRenderTimelineMessage, defaultRenderTrustedContent, defaultRenderUntrustedContent, defaultToolsToChatCompletionsTools, descriptionToChatCompletionsJsonSchema, extractReasoningFields, filterThoughts, renderChatCompletionsSystemPrompt, renderChatCompletionsToolCallResult, renderFirstPartyRetrievables, renderMemories, renderRetrievableSafetyDirective, renderRetrievables, renderStandingInstructions, renderThirdPartyPrivateRetrievables, renderThirdPartyPublicRetrievables, renderThought, renderTimelineMessage, renderTrustedContent, renderUntrustedContent, toolsToChatCompletionsTools } from "./openai_chat_completions/helpers.mjs";
 import { OpenAIChatCompletionsAdapter } from "./openai_chat_completions/adapter.mjs";
-export { E_INVALID_OPENAI_CHAT_COMPLETIONS_OPTIONS, E_OPENAI_CHAT_COMPLETIONS_CONTEXT_OVERFLOW, E_OPENAI_CHAT_COMPLETIONS_HTTP_ERROR, E_OPENAI_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS, E_OPENAI_CHAT_COMPLETIONS_REQUEST_TIMEOUT, E_OPENAI_CHAT_COMPLETIONS_STREAM_ERROR, E_OPENAI_CHAT_COMPLETIONS_STREAM_STALLED, OpenAIChatCompletionsAdapter, buildChatCompletionsHistory, createChatCompletionsToolCallDeltaAccumulator, defaultBuildChatCompletionsHistory, defaultCreateChatCompletionsToolCallDeltaAccumulator, defaultDescriptionToChatCompletionsJsonSchema, defaultFilterThoughts, defaultRenderChatCompletionsSystemPrompt, defaultRenderChatCompletionsToolCallResult, defaultRenderFirstPartyRetrievables, defaultRenderMemories, defaultRenderRetrievableSafetyDirective, defaultRenderRetrievables, defaultRenderStandingInstructions, defaultRenderThirdPartyPrivateRetrievables, defaultRenderThirdPartyPublicRetrievables, defaultRenderThought, defaultRenderTimelineMessage, defaultRenderTrustedContent, defaultRenderUntrustedContent, defaultToolsToChatCompletionsTools, descriptionToChatCompletionsJsonSchema, filterThoughts, openAIChatCompletionsOptionsSchema, renderChatCompletionsSystemPrompt, renderChatCompletionsToolCallResult, renderFirstPartyRetrievables, renderMemories, renderRetrievableSafetyDirective, renderRetrievables, renderStandingInstructions, renderThirdPartyPrivateRetrievables, renderThirdPartyPublicRetrievables, renderThought, renderTimelineMessage, renderTrustedContent, renderUntrustedContent, toolsToChatCompletionsTools, validateOptions };
+export { E_INVALID_OPENAI_CHAT_COMPLETIONS_OPTIONS, E_OPENAI_CHAT_COMPLETIONS_CONTEXT_OVERFLOW, E_OPENAI_CHAT_COMPLETIONS_HTTP_ERROR, E_OPENAI_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS, E_OPENAI_CHAT_COMPLETIONS_REQUEST_TIMEOUT, E_OPENAI_CHAT_COMPLETIONS_STREAM_ERROR, E_OPENAI_CHAT_COMPLETIONS_STREAM_STALLED, OpenAIChatCompletionsAdapter, buildChatCompletionsHistory, createChatCompletionsToolCallDeltaAccumulator, defaultBuildChatCompletionsHistory, defaultCreateChatCompletionsToolCallDeltaAccumulator, defaultDescriptionToChatCompletionsJsonSchema, defaultFilterThoughts, defaultRenderChatCompletionsSystemPrompt, defaultRenderChatCompletionsToolCallResult, defaultRenderFirstPartyRetrievables, defaultRenderMemories, defaultRenderRetrievableSafetyDirective, defaultRenderRetrievables, defaultRenderStandingInstructions, defaultRenderThirdPartyPrivateRetrievables, defaultRenderThirdPartyPublicRetrievables, defaultRenderThought, defaultRenderTimelineMessage, defaultRenderTrustedContent, defaultRenderUntrustedContent, defaultToolsToChatCompletionsTools, descriptionToChatCompletionsJsonSchema, extractReasoningFields, filterThoughts, openAIChatCompletionsOptionsSchema, renderChatCompletionsSystemPrompt, renderChatCompletionsToolCallResult, renderFirstPartyRetrievables, renderMemories, renderRetrievableSafetyDirective, renderRetrievables, renderStandingInstructions, renderThirdPartyPrivateRetrievables, renderThirdPartyPublicRetrievables, renderThought, renderTimelineMessage, renderTrustedContent, renderUntrustedContent, toolsToChatCompletionsTools, validateOptions };

package/batteries/llm/webllm_chat_completions/adapter.cjs

@@ -75,6 +75,7 @@ var ADK_CONTROL_KEYS = new Set([
 	"thoughtSurfacing",
 	"tokenEncoding",
 	"replayCompatibility",
+	"reasoningFieldPrecedence",
 	"helpers",
 	"strictToolChoice",
 	"unsupportedMediaPolicy",
@@ -510,6 +511,7 @@ var WebLLMChatCompletionsAdapter = class WebLLMChatCompletionsAdapter {
 				}));
 			};
 			const selfIdentity = merged.selfIdentity ?? "assistant";
+			const reasoningPrecedence = merged.reasoningFieldPrecedence ?? ["reasoning", "reasoning_content"];
 			if (stream) {
 				const chunks = completion;
 				if (!chunks || typeof chunks[Symbol.asyncIterator] !== "function") {
@@ -519,9 +521,10 @@ var WebLLMChatCompletionsAdapter = class WebLLMChatCompletionsAdapter {
 				const accumulator = resolvedHelpers.createChatCompletionsToolCallDeltaAccumulator();
 				const streamId = (0, uuid.v6)();
 				let partialMessageContent = "";
-				let partialThoughtContent = "";
 				let sawMessageDelta = false;
-				let sawThoughtDelta = false;
+				const thoughtAccum = /* @__PURE__ */ new Map();
+				let primaryThoughtField;
+				const thoughtStreamId = (field) => field === primaryThoughtField ? streamId : `${streamId}:${field}`;
 				const drainAndPersist = async () => {
 					if (sawMessageDelta) {
 						helpers.reportMessage(streamId, "", { isComplete: true });
@@ -534,24 +537,30 @@ var WebLLMChatCompletionsAdapter = class WebLLMChatCompletionsAdapter {
 							updatedAt: nowIso()
 						}));
 					}
-					if (sawThoughtDelta) {
-						helpers.reportThought(streamId, "", { isComplete: true });
-						await ctx.storeThought(new require_thought.Thought({
-							id: streamId,
-							content: partialThoughtContent,
-							identity: selfIdentity,
-							createdAt: nowIso(),
-							updatedAt: nowIso()
-						}));
-					}
+					for (const field of thoughtAccum.keys()) helpers.reportThought(thoughtStreamId(field), "", { isComplete: true });
+					const thoughtExtracts = require_batteries_llm_openai_chat_completions_helpers.extractReasoningFields(Object.fromEntries(thoughtAccum), reasoningPrecedence);
+					if (thoughtExtracts.length === 1) await ctx.storeThought(new require_thought.Thought({
+						id: streamId,
+						content: thoughtExtracts[0].content,
+						identity: selfIdentity,
+						createdAt: nowIso(),
+						updatedAt: nowIso()
+					}));
+					else for (const { field, content } of thoughtExtracts) await ctx.storeThought(new require_thought.Thought({
+						id: thoughtStreamId(field),
+						content,
+						identity: selfIdentity,
+						createdAt: nowIso(),
+						updatedAt: nowIso()
+					}));
 					const calls = accumulator.drain();
 					helpers.log.debug({
 						kind: "accumulator-finalised",
-						message: `Stream finalised: ${calls.length} tool call(s), message=${sawMessageDelta}, thought=${sawThoughtDelta}`,
+						message: `Stream finalised: ${calls.length} tool call(s), message=${sawMessageDelta}, thoughtFields=${thoughtExtracts.length}`,
 						payload: {
 							toolCallCount: calls.length,
 							sawMessageDelta,
-							sawThoughtDelta
+							thoughtFieldCount: thoughtExtracts.length
 						}
 					});
 					if (calls.length === 0) {
@@ -573,11 +582,15 @@ var WebLLMChatCompletionsAdapter = class WebLLMChatCompletionsAdapter {
 							partialMessageContent += delta.content;
 							helpers.reportMessage(streamId, delta.content);
 						}
-						const reasoning = delta.reasoning_content;
-						if (typeof reasoning === "string" && reasoning.length > 0) {
-							sawThoughtDelta = true;
-							partialThoughtContent += reasoning;
-							helpers.reportThought(streamId, reasoning);
+						for (const field of reasoningPrecedence) {
+							const reasoning = delta[field];
+							if (typeof reasoning !== "string" || reasoning.length === 0) continue;
+							if (!thoughtAccum.has(field)) {
+								primaryThoughtField ??= field;
+								thoughtAccum.set(field, "");
+							}
+							thoughtAccum.set(field, thoughtAccum.get(field) + reasoning);
+							helpers.reportThought(thoughtStreamId(field), reasoning);
 						}
 						if (Array.isArray(delta.tool_calls)) for (const d of delta.tool_calls) accumulator.feed(d);
 					}
@@ -614,13 +627,13 @@ var WebLLMChatCompletionsAdapter = class WebLLMChatCompletionsAdapter {
 					updatedAt: nowIso()
 				}));
 			}
-			const reasoning = msg?.reasoning_content;
-			if (typeof reasoning === "string" && reasoning.length > 0) {
-				const thoughtId = `${responseId}:thought`;
-				helpers.reportThought(thoughtId, reasoning, { isComplete: true });
+			const reasoningExtracts = require_batteries_llm_openai_chat_completions_helpers.extractReasoningFields(msg, reasoningPrecedence);
+			for (const { field, content } of reasoningExtracts) {
+				const thoughtId = reasoningExtracts.length > 1 ? `${responseId}:thought:${field}` : `${responseId}:thought`;
+				helpers.reportThought(thoughtId, content, { isComplete: true });
 				await ctx.storeThought(new require_thought.Thought({
 					id: thoughtId,
-					content: reasoning,
+					content,
 					identity: selfIdentity,
 					createdAt: nowIso(),
 					updatedAt: nowIso()

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          // 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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"}
+{"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  extractReasoningFields,\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  ReasoningField,\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  'reasoningFieldPrecedence',\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      const reasoningPrecedence = merged.reasoningFieldPrecedence ?? [\n        'reasoning',\n        'reasoning_content',\n      ]\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 sawMessageDelta = false\n\n        // Reasoning may stream under more than one provider-specific field at once. Accumulate each\n        // field's text under its own live stream id; at completion we dedup by content to decide\n        // whether to persist one Thought or one per divergent field. The first field to appear keeps\n        // the bare `streamId` (the common single-field case); any others get a `:field` suffix.\n        const thoughtAccum = new Map<ReasoningField, string>()\n        let primaryThoughtField: ReasoningField | undefined\n        const thoughtStreamId = (field: ReasoningField): string =>\n          field === primaryThoughtField ? streamId : `${streamId}:${field}`\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          // Finalize every reasoning stream we opened live, then dedup by content to decide how many\n          // Thoughts to persist: one (fields agreed, or only one present) vs one per divergent field.\n          for (const field of thoughtAccum.keys()) {\n            helpers.reportThought(thoughtStreamId(field), '', { isComplete: true })\n          }\n          const thoughtExtracts = extractReasoningFields(\n            Object.fromEntries(thoughtAccum) as Partial<Record<ReasoningField, string>>,\n            reasoningPrecedence\n          )\n          if (thoughtExtracts.length === 1) {\n            await ctx.storeThought(\n              new Thought({\n                id: streamId,\n                content: thoughtExtracts[0].content,\n                identity: selfIdentity,\n                createdAt: nowIso(),\n                updatedAt: nowIso(),\n              })\n            )\n          } else {\n            for (const { field, content } of thoughtExtracts) {\n              await ctx.storeThought(\n                new Thought({\n                  id: thoughtStreamId(field),\n                  content,\n                  identity: selfIdentity,\n                  createdAt: nowIso(),\n                  updatedAt: nowIso(),\n                })\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}, thoughtFields=${thoughtExtracts.length}`,\n            payload: {\n              toolCallCount: calls.length,\n              sawMessageDelta,\n              thoughtFieldCount: thoughtExtracts.length,\n            },\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            // Stream every reasoning field present on this delta, in precedence order. No\n            // mid-stream dedup — deltas are fragments; we compare full contents at completion.\n            for (const field of reasoningPrecedence) {\n              const reasoning = delta[field]\n              if (typeof reasoning !== 'string' || reasoning.length === 0) continue\n              if (!thoughtAccum.has(field)) {\n                primaryThoughtField ??= field\n                thoughtAccum.set(field, '')\n              }\n              thoughtAccum.set(field, thoughtAccum.get(field)! + reasoning)\n              helpers.reportThought(thoughtStreamId(field), 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      // Reasoning may arrive under more than one provider-specific field. A single extracted\n      // entry (only one field present, or several but identical) keeps the historical\n      // `${responseId}:thought` id; divergent fields each surface as their own thought.\n      const reasoningExtracts = extractReasoningFields(msg, reasoningPrecedence)\n      for (const { field, content } of reasoningExtracts) {\n        const thoughtId =\n          reasoningExtracts.length > 1 ? `${responseId}:thought:${field}` : `${responseId}:thought`\n        helpers.reportThought(thoughtId, content, { isComplete: true })\n        await ctx.storeThought(\n          new Thought({\n            id: thoughtId,\n            content,\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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"}