@nhtio/adk 1.20260607.2 → 1.20260609.0

package/batteries/llm/openai_chat_completions/validation.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../../chunk-Ble4zEEl.js");
-const require_common = require("../../../common-Cj8TaQ9U.js");
+const require_common = require("../../../common-DZl3ADJs.js");
 require("../../../guards.cjs");
 const require_batteries_llm_openai_chat_completions_exceptions = require("./exceptions.cjs");
 let _nhtio_validation = require("@nhtio/validation");
@@ -154,7 +154,7 @@ var openAIChatCompletionsOptionsSchema = _nhtio_validation.validator.object({
 	presence_penalty: _nhtio_validation.validator.number().min(-2).max(2).optional(),
 	prompt_cache_key: _nhtio_validation.validator.string().optional(),
 	prompt_cache_retention: _nhtio_validation.validator.string().valid("in_memory", "24h").optional(),
-	reasoning_effort: _nhtio_validation.validator.string().valid("minimal", "low", "medium", "high").optional(),
+	reasoning_effort: _nhtio_validation.validator.string().valid("none", "minimal", "low", "medium", "high").optional(),
 	response_format: responseFormatSchema.optional(),
 	safety_identifier: _nhtio_validation.validator.string().optional(),
 	seed: _nhtio_validation.validator.number().integer().optional(),

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

@@ -1 +1 @@
-{"version":3,"file":"validation.cjs","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    // `tokenEncoding?: TokenEncoding | null` — the field is OPTIONAL: a valid encoding string,\n    // explicit null, or absent (undefined = \"no token counting\"). `.optional()` makes the\n    // null/undefined disposition explicit (both allowed) per adk/require-validator-any-required,\n    // without rejecting the legitimate \"omitted\" case.\n    validator.any().valid(null).optional()\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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"}
+{"version":3,"file":"validation.cjs","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    // `tokenEncoding?: TokenEncoding | null` — the field is OPTIONAL: a valid encoding string,\n    // explicit null, or absent (undefined = \"no token counting\"). `.optional()` makes the\n    // null/undefined disposition explicit (both allowed) per adk/require-validator-any-required,\n    // without rejecting the legitimate \"omitted\" case.\n    validator.any().valid(null).optional()\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\n      .string()\n      .valid('none', 'minimal', 'low', 'medium', 'high')\n      .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/validation.mjs

@@ -1,4 +1,4 @@
-import { i as byteStoreSchema } from "../../../common-BT0nfCi9.mjs";
+import { i as byteStoreSchema } from "../../../common-DYDUi99O.mjs";
 import "../../../guards.mjs";
 import { E_INVALID_OPENAI_CHAT_COMPLETIONS_OPTIONS } from "./exceptions.mjs";
 import { validator } from "@nhtio/validation";
@@ -152,7 +152,7 @@ var openAIChatCompletionsOptionsSchema = validator.object({
 	presence_penalty: validator.number().min(-2).max(2).optional(),
 	prompt_cache_key: validator.string().optional(),
 	prompt_cache_retention: validator.string().valid("in_memory", "24h").optional(),
-	reasoning_effort: validator.string().valid("minimal", "low", "medium", "high").optional(),
+	reasoning_effort: validator.string().valid("none", "minimal", "low", "medium", "high").optional(),
 	response_format: responseFormatSchema.optional(),
 	safety_identifier: validator.string().optional(),
 	seed: validator.number().integer().optional(),

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 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    // `tokenEncoding?: TokenEncoding | null` — the field is OPTIONAL: a valid encoding string,\n    // explicit null, or absent (undefined = \"no token counting\"). `.optional()` makes the\n    // null/undefined disposition explicit (both allowed) per adk/require-validator-any-required,\n    // without rejecting the legitimate \"omitted\" case.\n    validator.any().valid(null).optional()\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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"}
+{"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    // `tokenEncoding?: TokenEncoding | null` — the field is OPTIONAL: a valid encoding string,\n    // explicit null, or absent (undefined = \"no token counting\"). `.optional()` makes the\n    // null/undefined disposition explicit (both allowed) per adk/require-validator-any-required,\n    // without rejecting the legitimate \"omitted\" case.\n    validator.any().valid(null).optional()\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\n      .string()\n      .valid('none', 'minimal', 'low', 'medium', 'high')\n      .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

@@ -2,6 +2,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../chunk-Ble4zEEl.js");
 const require_batteries_llm_openai_chat_completions_exceptions = require("./openai_chat_completions/exceptions.cjs");
 const require_batteries_llm_openai_chat_completions_validation = require("./openai_chat_completions/validation.cjs");
+const require_helpers = require("../../helpers-DSTFxTiC.js");
 const require_batteries_llm_openai_chat_completions_helpers = require("./openai_chat_completions/helpers.cjs");
 const require_batteries_llm_openai_chat_completions_adapter = require("./openai_chat_completions/adapter.cjs");
 exports.E_INVALID_OPENAI_CHAT_COMPLETIONS_OPTIONS = require_batteries_llm_openai_chat_completions_exceptions.E_INVALID_OPENAI_CHAT_COMPLETIONS_OPTIONS;
@@ -16,38 +17,38 @@ exports.buildChatCompletionsHistory = require_batteries_llm_openai_chat_completi
 exports.createChatCompletionsToolCallDeltaAccumulator = require_batteries_llm_openai_chat_completions_helpers.createChatCompletionsToolCallDeltaAccumulator;
 exports.defaultBuildChatCompletionsHistory = require_batteries_llm_openai_chat_completions_helpers.defaultBuildChatCompletionsHistory;
 exports.defaultCreateChatCompletionsToolCallDeltaAccumulator = require_batteries_llm_openai_chat_completions_helpers.defaultCreateChatCompletionsToolCallDeltaAccumulator;
-exports.defaultDescriptionToChatCompletionsJsonSchema = require_batteries_llm_openai_chat_completions_helpers.defaultDescriptionToChatCompletionsJsonSchema;
-exports.defaultFilterThoughts = require_batteries_llm_openai_chat_completions_helpers.defaultFilterThoughts;
-exports.defaultRenderChatCompletionsSystemPrompt = require_batteries_llm_openai_chat_completions_helpers.defaultRenderChatCompletionsSystemPrompt;
+exports.defaultDescriptionToChatCompletionsJsonSchema = require_helpers.defaultDescriptionToChatCompletionsJsonSchema;
+exports.defaultFilterThoughts = require_helpers.defaultFilterThoughts;
+exports.defaultRenderChatCompletionsSystemPrompt = require_helpers.defaultRenderChatCompletionsSystemPrompt;
 exports.defaultRenderChatCompletionsToolCallResult = require_batteries_llm_openai_chat_completions_helpers.defaultRenderChatCompletionsToolCallResult;
-exports.defaultRenderFirstPartyRetrievables = require_batteries_llm_openai_chat_completions_helpers.defaultRenderFirstPartyRetrievables;
-exports.defaultRenderMemories = require_batteries_llm_openai_chat_completions_helpers.defaultRenderMemories;
-exports.defaultRenderRetrievableSafetyDirective = require_batteries_llm_openai_chat_completions_helpers.defaultRenderRetrievableSafetyDirective;
-exports.defaultRenderRetrievables = require_batteries_llm_openai_chat_completions_helpers.defaultRenderRetrievables;
-exports.defaultRenderStandingInstructions = require_batteries_llm_openai_chat_completions_helpers.defaultRenderStandingInstructions;
-exports.defaultRenderThirdPartyPrivateRetrievables = require_batteries_llm_openai_chat_completions_helpers.defaultRenderThirdPartyPrivateRetrievables;
-exports.defaultRenderThirdPartyPublicRetrievables = require_batteries_llm_openai_chat_completions_helpers.defaultRenderThirdPartyPublicRetrievables;
-exports.defaultRenderThought = require_batteries_llm_openai_chat_completions_helpers.defaultRenderThought;
+exports.defaultRenderFirstPartyRetrievables = require_helpers.defaultRenderFirstPartyRetrievables;
+exports.defaultRenderMemories = require_helpers.defaultRenderMemories;
+exports.defaultRenderRetrievableSafetyDirective = require_helpers.defaultRenderRetrievableSafetyDirective;
+exports.defaultRenderRetrievables = require_helpers.defaultRenderRetrievables;
+exports.defaultRenderStandingInstructions = require_helpers.defaultRenderStandingInstructions;
+exports.defaultRenderThirdPartyPrivateRetrievables = require_helpers.defaultRenderThirdPartyPrivateRetrievables;
+exports.defaultRenderThirdPartyPublicRetrievables = require_helpers.defaultRenderThirdPartyPublicRetrievables;
+exports.defaultRenderThought = require_helpers.defaultRenderThought;
 exports.defaultRenderTimelineMessage = require_batteries_llm_openai_chat_completions_helpers.defaultRenderTimelineMessage;
-exports.defaultRenderTrustedContent = require_batteries_llm_openai_chat_completions_helpers.defaultRenderTrustedContent;
-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.defaultRenderTrustedContent = require_helpers.defaultRenderTrustedContent;
+exports.defaultRenderUntrustedContent = require_helpers.defaultRenderUntrustedContent;
+exports.defaultToolsToChatCompletionsTools = require_helpers.defaultToolsToChatCompletionsTools;
+exports.descriptionToChatCompletionsJsonSchema = require_helpers.descriptionToChatCompletionsJsonSchema;
 exports.extractReasoningFields = require_batteries_llm_openai_chat_completions_helpers.extractReasoningFields;
-exports.filterThoughts = require_batteries_llm_openai_chat_completions_helpers.filterThoughts;
+exports.filterThoughts = require_helpers.filterThoughts;
 exports.openAIChatCompletionsOptionsSchema = require_batteries_llm_openai_chat_completions_validation.openAIChatCompletionsOptionsSchema;
-exports.renderChatCompletionsSystemPrompt = require_batteries_llm_openai_chat_completions_helpers.renderChatCompletionsSystemPrompt;
+exports.renderChatCompletionsSystemPrompt = require_helpers.renderChatCompletionsSystemPrompt;
 exports.renderChatCompletionsToolCallResult = require_batteries_llm_openai_chat_completions_helpers.renderChatCompletionsToolCallResult;
-exports.renderFirstPartyRetrievables = require_batteries_llm_openai_chat_completions_helpers.renderFirstPartyRetrievables;
-exports.renderMemories = require_batteries_llm_openai_chat_completions_helpers.renderMemories;
-exports.renderRetrievableSafetyDirective = require_batteries_llm_openai_chat_completions_helpers.renderRetrievableSafetyDirective;
-exports.renderRetrievables = require_batteries_llm_openai_chat_completions_helpers.renderRetrievables;
-exports.renderStandingInstructions = require_batteries_llm_openai_chat_completions_helpers.renderStandingInstructions;
-exports.renderThirdPartyPrivateRetrievables = require_batteries_llm_openai_chat_completions_helpers.renderThirdPartyPrivateRetrievables;
-exports.renderThirdPartyPublicRetrievables = require_batteries_llm_openai_chat_completions_helpers.renderThirdPartyPublicRetrievables;
-exports.renderThought = require_batteries_llm_openai_chat_completions_helpers.renderThought;
+exports.renderFirstPartyRetrievables = require_helpers.renderFirstPartyRetrievables;
+exports.renderMemories = require_helpers.renderMemories;
+exports.renderRetrievableSafetyDirective = require_helpers.renderRetrievableSafetyDirective;
+exports.renderRetrievables = require_helpers.renderRetrievables;
+exports.renderStandingInstructions = require_helpers.renderStandingInstructions;
+exports.renderThirdPartyPrivateRetrievables = require_helpers.renderThirdPartyPrivateRetrievables;
+exports.renderThirdPartyPublicRetrievables = require_helpers.renderThirdPartyPublicRetrievables;
+exports.renderThought = require_helpers.renderThought;
 exports.renderTimelineMessage = require_batteries_llm_openai_chat_completions_helpers.renderTimelineMessage;
-exports.renderTrustedContent = require_batteries_llm_openai_chat_completions_helpers.renderTrustedContent;
-exports.renderUntrustedContent = require_batteries_llm_openai_chat_completions_helpers.renderUntrustedContent;
-exports.toolsToChatCompletionsTools = require_batteries_llm_openai_chat_completions_helpers.toolsToChatCompletionsTools;
+exports.renderTrustedContent = require_helpers.renderTrustedContent;
+exports.renderUntrustedContent = require_helpers.renderUntrustedContent;
+exports.toolsToChatCompletionsTools = require_helpers.toolsToChatCompletionsTools;
 exports.validateOptions = require_batteries_llm_openai_chat_completions_validation.validateOptions;

package/batteries/llm/openai_chat_completions.mjs

@@ -1,5 +1,6 @@
 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, extractReasoningFields, filterThoughts, renderChatCompletionsSystemPrompt, renderChatCompletionsToolCallResult, renderFirstPartyRetrievables, renderMemories, renderRetrievableSafetyDirective, renderRetrievables, renderStandingInstructions, renderThirdPartyPrivateRetrievables, renderThirdPartyPublicRetrievables, renderThought, renderTimelineMessage, renderTrustedContent, renderUntrustedContent, toolsToChatCompletionsTools } from "./openai_chat_completions/helpers.mjs";
+import { C as renderRetrievables, D as renderThought, E as renderThirdPartyPublicRetrievables, M as toolsToChatCompletionsTools, O as renderTrustedContent, S as renderRetrievableSafetyDirective, T as renderThirdPartyPrivateRetrievables, _ as filterThoughts, a as defaultRenderMemories, b as renderFirstPartyRetrievables, c as defaultRenderStandingInstructions, d as defaultRenderThought, f as defaultRenderTrustedContent, h as descriptionToChatCompletionsJsonSchema, i as defaultRenderFirstPartyRetrievables, k as renderUntrustedContent, l as defaultRenderThirdPartyPrivateRetrievables, m as defaultToolsToChatCompletionsTools, n as defaultFilterThoughts, o as defaultRenderRetrievableSafetyDirective, p as defaultRenderUntrustedContent, r as defaultRenderChatCompletionsSystemPrompt, s as defaultRenderRetrievables, t as defaultDescriptionToChatCompletionsJsonSchema, u as defaultRenderThirdPartyPublicRetrievables, w as renderStandingInstructions, x as renderMemories, y as renderChatCompletionsSystemPrompt } from "../../helpers-xhrQbMAG.mjs";
+import { buildChatCompletionsHistory, createChatCompletionsToolCallDeltaAccumulator, defaultBuildChatCompletionsHistory, defaultCreateChatCompletionsToolCallDeltaAccumulator, defaultRenderChatCompletionsToolCallResult, defaultRenderTimelineMessage, extractReasoningFields, renderChatCompletionsToolCallResult, renderTimelineMessage } 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, 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

@@ -1,12 +1,13 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../../chunk-Ble4zEEl.js");
-const require_tool_registry = require("../../../tool_registry-DYUYqXvo.js");
-const require_thought = require("../../../thought-BbwhJ1wb.js");
-const require_spooled_artifact = require("../../../spooled_artifact-BTq6Nzfy.js");
-require("../../../common-Cj8TaQ9U.js");
-const require_tool_call = require("../../../tool_call-Db68hB7y.js");
+const require_tool_registry = require("../../../tool_registry-CKJPze3j.js");
+const require_thought = require("../../../thought-DLwpF7MI.js");
+const require_spooled_artifact = require("../../../spooled_artifact-DX8LLyUX.js");
+require("../../../common-DZl3ADJs.js");
+const require_tool_call = require("../../../tool_call-DixVlW40.js");
 require("../../../guards.cjs");
 const require_batteries_storage_in_memory = require("../../storage/in_memory.cjs");
+const require_helpers = require("../../../helpers-DSTFxTiC.js");
 const require_batteries_llm_openai_chat_completions_helpers = require("../openai_chat_completions/helpers.cjs");
 const require_batteries_llm_webllm_chat_completions_exceptions = require("./exceptions.cjs");
 const require_batteries_llm_webllm_chat_completions_validation = require("./validation.cjs");
@@ -113,21 +114,21 @@ var mergeOptions = (baseline, exec, stash) => {
 var resolveHelpers = (overrides) => {
 	const src = overrides ?? {};
 	return {
-		descriptionToChatCompletionsJsonSchema: src.descriptionToChatCompletionsJsonSchema ?? require_batteries_llm_openai_chat_completions_helpers.defaultDescriptionToChatCompletionsJsonSchema,
-		renderUntrustedContent: src.renderUntrustedContent ?? require_batteries_llm_openai_chat_completions_helpers.defaultRenderUntrustedContent,
-		renderTrustedContent: src.renderTrustedContent ?? require_batteries_llm_openai_chat_completions_helpers.defaultRenderTrustedContent,
-		renderStandingInstructions: src.renderStandingInstructions ?? require_batteries_llm_openai_chat_completions_helpers.defaultRenderStandingInstructions,
-		renderMemories: src.renderMemories ?? require_batteries_llm_openai_chat_completions_helpers.defaultRenderMemories,
-		renderRetrievables: src.renderRetrievables ?? require_batteries_llm_openai_chat_completions_helpers.defaultRenderRetrievables,
-		renderRetrievableSafetyDirective: src.renderRetrievableSafetyDirective ?? require_batteries_llm_openai_chat_completions_helpers.defaultRenderRetrievableSafetyDirective,
-		renderFirstPartyRetrievables: src.renderFirstPartyRetrievables ?? require_batteries_llm_openai_chat_completions_helpers.defaultRenderFirstPartyRetrievables,
-		renderThirdPartyPublicRetrievables: src.renderThirdPartyPublicRetrievables ?? require_batteries_llm_openai_chat_completions_helpers.defaultRenderThirdPartyPublicRetrievables,
-		renderThirdPartyPrivateRetrievables: src.renderThirdPartyPrivateRetrievables ?? require_batteries_llm_openai_chat_completions_helpers.defaultRenderThirdPartyPrivateRetrievables,
+		descriptionToChatCompletionsJsonSchema: src.descriptionToChatCompletionsJsonSchema ?? require_helpers.defaultDescriptionToChatCompletionsJsonSchema,
+		renderUntrustedContent: src.renderUntrustedContent ?? require_helpers.defaultRenderUntrustedContent,
+		renderTrustedContent: src.renderTrustedContent ?? require_helpers.defaultRenderTrustedContent,
+		renderStandingInstructions: src.renderStandingInstructions ?? require_helpers.defaultRenderStandingInstructions,
+		renderMemories: src.renderMemories ?? require_helpers.defaultRenderMemories,
+		renderRetrievables: src.renderRetrievables ?? require_helpers.defaultRenderRetrievables,
+		renderRetrievableSafetyDirective: src.renderRetrievableSafetyDirective ?? require_helpers.defaultRenderRetrievableSafetyDirective,
+		renderFirstPartyRetrievables: src.renderFirstPartyRetrievables ?? require_helpers.defaultRenderFirstPartyRetrievables,
+		renderThirdPartyPublicRetrievables: src.renderThirdPartyPublicRetrievables ?? require_helpers.defaultRenderThirdPartyPublicRetrievables,
+		renderThirdPartyPrivateRetrievables: src.renderThirdPartyPrivateRetrievables ?? require_helpers.defaultRenderThirdPartyPrivateRetrievables,
 		renderTimelineMessage: src.renderTimelineMessage ?? require_batteries_llm_openai_chat_completions_helpers.defaultRenderTimelineMessage,
-		renderThought: src.renderThought ?? require_batteries_llm_openai_chat_completions_helpers.defaultRenderThought,
-		filterThoughts: src.filterThoughts ?? require_batteries_llm_openai_chat_completions_helpers.defaultFilterThoughts,
-		toolsToChatCompletionsTools: src.toolsToChatCompletionsTools ?? require_batteries_llm_openai_chat_completions_helpers.defaultToolsToChatCompletionsTools,
-		renderChatCompletionsSystemPrompt: src.renderChatCompletionsSystemPrompt ?? require_batteries_llm_openai_chat_completions_helpers.defaultRenderChatCompletionsSystemPrompt,
+		renderThought: src.renderThought ?? require_helpers.defaultRenderThought,
+		filterThoughts: src.filterThoughts ?? require_helpers.defaultFilterThoughts,
+		toolsToChatCompletionsTools: src.toolsToChatCompletionsTools ?? require_helpers.defaultToolsToChatCompletionsTools,
+		renderChatCompletionsSystemPrompt: src.renderChatCompletionsSystemPrompt ?? require_helpers.defaultRenderChatCompletionsSystemPrompt,
 		renderChatCompletionsToolCallResult: src.renderChatCompletionsToolCallResult ?? require_batteries_llm_openai_chat_completions_helpers.defaultRenderChatCompletionsToolCallResult,
 		buildChatCompletionsHistory: src.buildChatCompletionsHistory ?? require_batteries_llm_openai_chat_completions_helpers.defaultBuildChatCompletionsHistory,
 		createChatCompletionsToolCallDeltaAccumulator: src.createChatCompletionsToolCallDeltaAccumulator ?? require_batteries_llm_openai_chat_completions_helpers.defaultCreateChatCompletionsToolCallDeltaAccumulator
@@ -167,6 +168,11 @@ var WebLLMChatCompletionsAdapter = class WebLLMChatCompletionsAdapter {
 	#baseline;
 	#engine;
 	#enginePromise;
+	/**
+	* Whether the runtime can host a WebLLM engine — i.e. WebGPU (`navigator.gpu`) is present.
+	*
+	* @returns `true` when WebGPU is available in the current environment.
+	*/
 	static isAvailable() {
 		return typeof globalThis.navigator !== "undefined" && "gpu" in globalThis.navigator && typeof globalThis.navigator.gpu !== "undefined";
 	}
@@ -180,14 +186,27 @@ var WebLLMChatCompletionsAdapter = class WebLLMChatCompletionsAdapter {
 		this.#baseline = require_batteries_llm_webllm_chat_completions_validation.validateOptions(options);
 		this.#engine = this.#baseline.engine;
 	}
+	/**
+	* Eagerly loads (and caches) the engine so the first dispatch does not pay the model-load cost.
+	*
+	* @param overrides - Optional option overrides layered over the constructor baseline.
+	* @returns The resolved {@link WebLLMEngine}.
+	*/
 	async preload(overrides) {
 		const merged = require_batteries_llm_webllm_chat_completions_validation.validateOptions(mergeOptions(this.#baseline, overrides, void 0));
 		return this.#resolveEngine(merged);
 	}
+	/** Drops the cached engine and any in-flight load so the next dispatch re-resolves it. */
 	reset() {
 		this.#engine = void 0;
 		this.#enginePromise = void 0;
 	}
+	/**
+	* Instance-level availability check, honouring an injected
+	* {@link WebLLMChatCompletionsAdapterOptions.isWebGPUAvailable} override.
+	*
+	* @returns `true` when a WebLLM engine can run in the current environment.
+	*/
 	isAvailable() {
 		return (this.#baseline.isWebGPUAvailable ?? WebLLMChatCompletionsAdapter.isAvailable)();
 	}