@nhtio/adk 0.1.0-master-f0aa531d

package/batteries/llm/openai_chat_completions/validation.cjs

@@ -0,0 +1,190 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../../../chunk-KmRHZBOW.js");
+require("../../../guards.cjs");
+const require_batteries_llm_openai_chat_completions_exceptions = require("./exceptions.cjs");
+let _nhtio_validation = require("@nhtio/validation");
+//#region src/batteries/llm/openai_chat_completions/validation.ts
+var jsonSchemaSchema = _nhtio_validation.validator.object().unknown(true);
+var bucketLabelSchema = _nhtio_validation.validator.string().valid("standingInstructions", "memories", "retrievables", "timeline");
+var bucketOrderSchema = _nhtio_validation.validator.array().items(bucketLabelSchema).unique().default([
+	"standingInstructions",
+	"memories",
+	"retrievables",
+	"timeline"
+]);
+var tokenEncodingSchema = _nhtio_validation.validator.alternatives(_nhtio_validation.validator.string().valid("gpt2", "r50k_base", "p50k_base", "p50k_edit", "cl100k_base", "o200k_base", "gemini", "llama2", "claude"), _nhtio_validation.validator.any().valid(null)).default(null);
+var retrySchema = _nhtio_validation.validator.object({
+	maxAttempts: _nhtio_validation.validator.number().integer().min(1).default(1),
+	baseDelayMs: _nhtio_validation.validator.number().integer().min(0).default(500),
+	maxDelayMs: _nhtio_validation.validator.number().integer().min(1).default(3e4),
+	retriableStatuses: _nhtio_validation.validator.array().items(_nhtio_validation.validator.number().integer().min(100).max(599)).default([
+		429,
+		502,
+		503,
+		504
+	]),
+	honorRetryAfter: _nhtio_validation.validator.boolean().default(true)
+}).unknown(false);
+var helperSchema = _nhtio_validation.validator.function();
+var helpersSchema = _nhtio_validation.validator.object({
+	descriptionToChatCompletionsJsonSchema: helperSchema.optional(),
+	renderUntrustedContent: helperSchema.optional(),
+	renderTrustedContent: helperSchema.optional(),
+	renderStandingInstructions: helperSchema.optional(),
+	renderMemories: helperSchema.optional(),
+	renderRetrievables: helperSchema.optional(),
+	renderRetrievableSafetyDirective: helperSchema.optional(),
+	renderFirstPartyRetrievables: helperSchema.optional(),
+	renderThirdPartyPublicRetrievables: helperSchema.optional(),
+	renderThirdPartyPrivateRetrievables: helperSchema.optional(),
+	renderTimelineMessage: helperSchema.optional(),
+	renderThought: helperSchema.optional(),
+	filterThoughts: helperSchema.optional(),
+	toolsToChatCompletionsTools: helperSchema.optional(),
+	renderChatCompletionsSystemPrompt: helperSchema.optional(),
+	renderChatCompletionsToolCallResult: helperSchema.optional(),
+	buildChatCompletionsHistory: helperSchema.optional(),
+	createChatCompletionsToolCallDeltaAccumulator: helperSchema.optional()
+}).unknown(false);
+var audioSchema = _nhtio_validation.validator.object({
+	voice: _nhtio_validation.validator.string().required(),
+	format: _nhtio_validation.validator.string().valid("wav", "mp3", "flac", "opus", "pcm16").required()
+}).unknown(false);
+var functionCallSchema = _nhtio_validation.validator.alternatives(_nhtio_validation.validator.string().valid("none", "auto"), _nhtio_validation.validator.object({ name: _nhtio_validation.validator.string().required() }).unknown(false));
+var functionsItemSchema = _nhtio_validation.validator.object({
+	name: _nhtio_validation.validator.string().required(),
+	description: _nhtio_validation.validator.string().optional(),
+	parameters: jsonSchemaSchema.optional()
+}).unknown(false);
+var predictionSchema = _nhtio_validation.validator.object({
+	type: _nhtio_validation.validator.string().valid("content").required(),
+	content: _nhtio_validation.validator.alternatives(_nhtio_validation.validator.string(), _nhtio_validation.validator.array().items(_nhtio_validation.validator.object({
+		type: _nhtio_validation.validator.string().valid("text").required(),
+		text: _nhtio_validation.validator.string().required()
+	}).unknown(false))).required()
+}).unknown(false);
+var responseFormatSchema = _nhtio_validation.validator.alternatives(_nhtio_validation.validator.object({ type: _nhtio_validation.validator.string().valid("text").required() }).unknown(false), _nhtio_validation.validator.object({ type: _nhtio_validation.validator.string().valid("json_object").required() }).unknown(false), _nhtio_validation.validator.object({
+	type: _nhtio_validation.validator.string().valid("json_schema").required(),
+	json_schema: _nhtio_validation.validator.object({
+		name: _nhtio_validation.validator.string().required(),
+		schema: jsonSchemaSchema.required(),
+		strict: _nhtio_validation.validator.boolean().optional(),
+		description: _nhtio_validation.validator.string().optional()
+	}).unknown(false).required()
+}).unknown(false));
+var toolChoiceItemSchema = _nhtio_validation.validator.alternatives(_nhtio_validation.validator.object({
+	type: _nhtio_validation.validator.string().valid("function").required(),
+	function: _nhtio_validation.validator.object({ name: _nhtio_validation.validator.string().required() }).unknown(false).required()
+}).unknown(false), _nhtio_validation.validator.object({
+	type: _nhtio_validation.validator.string().valid("custom").required(),
+	custom: _nhtio_validation.validator.object({ name: _nhtio_validation.validator.string().required() }).unknown(false).required()
+}).unknown(false));
+var toolChoiceSchema = _nhtio_validation.validator.alternatives(_nhtio_validation.validator.string().valid("none", "auto", "required"), toolChoiceItemSchema, _nhtio_validation.validator.object({
+	type: _nhtio_validation.validator.string().valid("allowed_tools").required(),
+	allowed_tools: _nhtio_validation.validator.object({
+		mode: _nhtio_validation.validator.string().valid("auto", "required").required(),
+		tools: _nhtio_validation.validator.array().items(toolChoiceItemSchema).required()
+	}).unknown(false).required()
+}).unknown(false));
+var streamOptionsSchema = _nhtio_validation.validator.object({
+	include_usage: _nhtio_validation.validator.boolean().optional(),
+	include_obfuscation: _nhtio_validation.validator.boolean().optional()
+}).unknown(false);
+var webSearchOptionsSchema = _nhtio_validation.validator.object({
+	search_context_size: _nhtio_validation.validator.string().valid("low", "medium", "high").optional(),
+	user_location: _nhtio_validation.validator.object({
+		type: _nhtio_validation.validator.string().valid("approximate").required(),
+		approximate: _nhtio_validation.validator.object({
+			city: _nhtio_validation.validator.string().optional(),
+			country: _nhtio_validation.validator.string().optional(),
+			region: _nhtio_validation.validator.string().optional(),
+			timezone: _nhtio_validation.validator.string().optional()
+		}).unknown(false).required()
+	}).unknown(false).optional()
+}).unknown(false);
+/**
+* Validator schema for `OpenAIChatCompletionsAdapterOptions`.
+*
+* @remarks
+* Used by `validateOptions` at construction time and again at the start of every iteration after
+* options have been merged (stash > executor > constructor). Rejects unknown top-level keys
+* so typos and removed fields (`bucketBudgets`, `maxInlineToolResultFraction`, `trustedTools`)
+* fail loud.
+*/
+var openAIChatCompletionsOptionsSchema = _nhtio_validation.validator.object({
+	apiKey: _nhtio_validation.validator.string().optional(),
+	baseURL: _nhtio_validation.validator.string().optional(),
+	headers: _nhtio_validation.validator.object().pattern(_nhtio_validation.validator.string(), _nhtio_validation.validator.string()).optional(),
+	stream: _nhtio_validation.validator.boolean().default(true),
+	streamIdleTimeoutMs: _nhtio_validation.validator.number().integer().min(0).default(0),
+	requestTimeoutMs: _nhtio_validation.validator.number().integer().min(0).default(0),
+	retry: retrySchema.optional(),
+	fetch: _nhtio_validation.validator.function().optional(),
+	bucketOrder: bucketOrderSchema,
+	contextWindow: _nhtio_validation.validator.number().integer().min(1).optional(),
+	selfIdentity: _nhtio_validation.validator.string().min(1).default("assistant"),
+	thoughtSurfacing: _nhtio_validation.validator.string().valid("all-self", "latest-self", "all").default("all-self"),
+	tokenEncoding: tokenEncodingSchema,
+	replayCompatibility: _nhtio_validation.validator.array().items(_nhtio_validation.validator.string().min(1)).default([]),
+	helpers: helpersSchema.optional(),
+	strictToolChoice: _nhtio_validation.validator.boolean().default(false),
+	autoAck: _nhtio_validation.validator.boolean().default(false),
+	unsupportedMediaPolicy: _nhtio_validation.validator.alternatives(_nhtio_validation.validator.string().valid("throw", "fallback-stash", "synthetic-description"), _nhtio_validation.validator.object({
+		mode: _nhtio_validation.validator.string().valid("fallback-stash").required(),
+		stashKeys: _nhtio_validation.validator.array().items(_nhtio_validation.validator.string().min(1)).required()
+	}).unknown(false)).default("throw"),
+	model: _nhtio_validation.validator.string().required(),
+	audio: audioSchema.optional(),
+	frequency_penalty: _nhtio_validation.validator.number().min(-2).max(2).optional(),
+	function_call: functionCallSchema.optional(),
+	functions: _nhtio_validation.validator.array().items(functionsItemSchema).optional(),
+	logit_bias: _nhtio_validation.validator.object().pattern(_nhtio_validation.validator.string(), _nhtio_validation.validator.number()).optional(),
+	logprobs: _nhtio_validation.validator.boolean().optional(),
+	max_completion_tokens: _nhtio_validation.validator.number().integer().min(1).optional(),
+	max_tokens: _nhtio_validation.validator.number().integer().min(1).optional(),
+	metadata: _nhtio_validation.validator.object().pattern(_nhtio_validation.validator.string(), _nhtio_validation.validator.string()).optional(),
+	modalities: _nhtio_validation.validator.array().items(_nhtio_validation.validator.string().valid("text", "audio")).optional(),
+	n: _nhtio_validation.validator.number().integer().min(1).optional(),
+	parallel_tool_calls: _nhtio_validation.validator.boolean().optional(),
+	prediction: predictionSchema.optional(),
+	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(),
+	response_format: responseFormatSchema.optional(),
+	safety_identifier: _nhtio_validation.validator.string().optional(),
+	seed: _nhtio_validation.validator.number().integer().optional(),
+	service_tier: _nhtio_validation.validator.string().valid("auto", "default", "flex", "priority", "scale").optional(),
+	stop: _nhtio_validation.validator.alternatives(_nhtio_validation.validator.string(), _nhtio_validation.validator.array().items(_nhtio_validation.validator.string())).optional(),
+	store: _nhtio_validation.validator.boolean().optional(),
+	stream_options: streamOptionsSchema.optional(),
+	temperature: _nhtio_validation.validator.number().min(0).max(2).optional(),
+	tool_choice: toolChoiceSchema.optional(),
+	top_logprobs: _nhtio_validation.validator.number().integer().min(0).max(20).optional(),
+	top_p: _nhtio_validation.validator.number().min(0).max(1).optional(),
+	user: _nhtio_validation.validator.string().optional(),
+	verbosity: _nhtio_validation.validator.string().valid("low", "medium", "high").optional(),
+	web_search_options: webSearchOptionsSchema.optional()
+}).unknown(false);
+var formatValidationDetails = (err) => err.details.map((d) => d.message).join(" and ");
+/**
+* Validates an arbitrary input against `openAIChatCompletionsOptionsSchema` and returns the
+* resolved options shape. Throws `E_INVALID_OPENAI_CHAT_COMPLETIONS_OPTIONS` (carrying the
+* validator's error report on `cause`) on failure.
+*
+* @param input - The raw options object to validate.
+* @returns The resolved options object with defaults filled in.
+*/
+var validateOptions = (input) => {
+	const { value, error } = openAIChatCompletionsOptionsSchema.validate(input, {
+		abortEarly: false,
+		convert: false
+	});
+	if (error) throw new require_batteries_llm_openai_chat_completions_exceptions.E_INVALID_OPENAI_CHAT_COMPLETIONS_OPTIONS([formatValidationDetails(error)], { cause: error });
+	return value;
+};
+//#endregion
+exports.openAIChatCompletionsOptionsSchema = openAIChatCompletionsOptionsSchema;
+exports.validateOptions = validateOptions;
+
+//# sourceMappingURL=validation.cjs.map

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

@@ -0,0 +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 { 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    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/validation.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Runtime validation schema and wrapper for OpenAI Chat Completions adapter options.
+ *
+ * @module @nhtio/adk/batteries/llm/openai_chat_completions/validation
+ *
+ * @remarks
+ * Schema and call-site wrapper for validating `OpenAIChatCompletionsAdapterOptions`. Used at
+ * construction time and at the start of every iteration against the merged options shape
+ * (stash > executor > constructor). Throws `E_INVALID_OPENAI_CHAT_COMPLETIONS_OPTIONS` on
+ * failure — same hard-fail policy as every other ADK contract.
+ */
+import type { OpenAIChatCompletionsAdapterOptions } from "./types";
+/**
+ * Validator schema for `OpenAIChatCompletionsAdapterOptions`.
+ *
+ * @remarks
+ * Used by `validateOptions` at construction time and again at the start of every iteration after
+ * options have been merged (stash > executor > constructor). Rejects unknown top-level keys
+ * so typos and removed fields (`bucketBudgets`, `maxInlineToolResultFraction`, `trustedTools`)
+ * fail loud.
+ */
+export declare const openAIChatCompletionsOptionsSchema: import("@nhtio/validation").ObjectSchema<OpenAIChatCompletionsAdapterOptions>;
+/**
+ * Validates an arbitrary input against `openAIChatCompletionsOptionsSchema` and returns the
+ * resolved options shape. Throws `E_INVALID_OPENAI_CHAT_COMPLETIONS_OPTIONS` (carrying the
+ * validator's error report on `cause`) on failure.
+ *
+ * @param input - The raw options object to validate.
+ * @returns The resolved options object with defaults filled in.
+ */
+export declare const validateOptions: (input: unknown) => OpenAIChatCompletionsAdapterOptions;

package/batteries/llm/openai_chat_completions/validation.mjs

@@ -0,0 +1,187 @@
+import "../../../guards.mjs";
+import { E_INVALID_OPENAI_CHAT_COMPLETIONS_OPTIONS } from "./exceptions.mjs";
+import { validator } from "@nhtio/validation";
+//#region src/batteries/llm/openai_chat_completions/validation.ts
+var jsonSchemaSchema = validator.object().unknown(true);
+var bucketLabelSchema = validator.string().valid("standingInstructions", "memories", "retrievables", "timeline");
+var bucketOrderSchema = validator.array().items(bucketLabelSchema).unique().default([
+	"standingInstructions",
+	"memories",
+	"retrievables",
+	"timeline"
+]);
+var tokenEncodingSchema = validator.alternatives(validator.string().valid("gpt2", "r50k_base", "p50k_base", "p50k_edit", "cl100k_base", "o200k_base", "gemini", "llama2", "claude"), validator.any().valid(null)).default(null);
+var retrySchema = validator.object({
+	maxAttempts: validator.number().integer().min(1).default(1),
+	baseDelayMs: validator.number().integer().min(0).default(500),
+	maxDelayMs: validator.number().integer().min(1).default(3e4),
+	retriableStatuses: validator.array().items(validator.number().integer().min(100).max(599)).default([
+		429,
+		502,
+		503,
+		504
+	]),
+	honorRetryAfter: validator.boolean().default(true)
+}).unknown(false);
+var helperSchema = validator.function();
+var helpersSchema = validator.object({
+	descriptionToChatCompletionsJsonSchema: helperSchema.optional(),
+	renderUntrustedContent: helperSchema.optional(),
+	renderTrustedContent: helperSchema.optional(),
+	renderStandingInstructions: helperSchema.optional(),
+	renderMemories: helperSchema.optional(),
+	renderRetrievables: helperSchema.optional(),
+	renderRetrievableSafetyDirective: helperSchema.optional(),
+	renderFirstPartyRetrievables: helperSchema.optional(),
+	renderThirdPartyPublicRetrievables: helperSchema.optional(),
+	renderThirdPartyPrivateRetrievables: helperSchema.optional(),
+	renderTimelineMessage: helperSchema.optional(),
+	renderThought: helperSchema.optional(),
+	filterThoughts: helperSchema.optional(),
+	toolsToChatCompletionsTools: helperSchema.optional(),
+	renderChatCompletionsSystemPrompt: helperSchema.optional(),
+	renderChatCompletionsToolCallResult: helperSchema.optional(),
+	buildChatCompletionsHistory: helperSchema.optional(),
+	createChatCompletionsToolCallDeltaAccumulator: helperSchema.optional()
+}).unknown(false);
+var audioSchema = validator.object({
+	voice: validator.string().required(),
+	format: validator.string().valid("wav", "mp3", "flac", "opus", "pcm16").required()
+}).unknown(false);
+var functionCallSchema = validator.alternatives(validator.string().valid("none", "auto"), validator.object({ name: validator.string().required() }).unknown(false));
+var functionsItemSchema = validator.object({
+	name: validator.string().required(),
+	description: validator.string().optional(),
+	parameters: jsonSchemaSchema.optional()
+}).unknown(false);
+var predictionSchema = validator.object({
+	type: validator.string().valid("content").required(),
+	content: validator.alternatives(validator.string(), validator.array().items(validator.object({
+		type: validator.string().valid("text").required(),
+		text: validator.string().required()
+	}).unknown(false))).required()
+}).unknown(false);
+var responseFormatSchema = validator.alternatives(validator.object({ type: validator.string().valid("text").required() }).unknown(false), validator.object({ type: validator.string().valid("json_object").required() }).unknown(false), validator.object({
+	type: validator.string().valid("json_schema").required(),
+	json_schema: validator.object({
+		name: validator.string().required(),
+		schema: jsonSchemaSchema.required(),
+		strict: validator.boolean().optional(),
+		description: validator.string().optional()
+	}).unknown(false).required()
+}).unknown(false));
+var toolChoiceItemSchema = validator.alternatives(validator.object({
+	type: validator.string().valid("function").required(),
+	function: validator.object({ name: validator.string().required() }).unknown(false).required()
+}).unknown(false), validator.object({
+	type: validator.string().valid("custom").required(),
+	custom: validator.object({ name: validator.string().required() }).unknown(false).required()
+}).unknown(false));
+var toolChoiceSchema = validator.alternatives(validator.string().valid("none", "auto", "required"), toolChoiceItemSchema, validator.object({
+	type: validator.string().valid("allowed_tools").required(),
+	allowed_tools: validator.object({
+		mode: validator.string().valid("auto", "required").required(),
+		tools: validator.array().items(toolChoiceItemSchema).required()
+	}).unknown(false).required()
+}).unknown(false));
+var streamOptionsSchema = validator.object({
+	include_usage: validator.boolean().optional(),
+	include_obfuscation: validator.boolean().optional()
+}).unknown(false);
+var webSearchOptionsSchema = validator.object({
+	search_context_size: validator.string().valid("low", "medium", "high").optional(),
+	user_location: validator.object({
+		type: validator.string().valid("approximate").required(),
+		approximate: validator.object({
+			city: validator.string().optional(),
+			country: validator.string().optional(),
+			region: validator.string().optional(),
+			timezone: validator.string().optional()
+		}).unknown(false).required()
+	}).unknown(false).optional()
+}).unknown(false);
+/**
+* Validator schema for `OpenAIChatCompletionsAdapterOptions`.
+*
+* @remarks
+* Used by `validateOptions` at construction time and again at the start of every iteration after
+* options have been merged (stash > executor > constructor). Rejects unknown top-level keys
+* so typos and removed fields (`bucketBudgets`, `maxInlineToolResultFraction`, `trustedTools`)
+* fail loud.
+*/
+var openAIChatCompletionsOptionsSchema = validator.object({
+	apiKey: validator.string().optional(),
+	baseURL: validator.string().optional(),
+	headers: validator.object().pattern(validator.string(), validator.string()).optional(),
+	stream: validator.boolean().default(true),
+	streamIdleTimeoutMs: validator.number().integer().min(0).default(0),
+	requestTimeoutMs: validator.number().integer().min(0).default(0),
+	retry: retrySchema.optional(),
+	fetch: validator.function().optional(),
+	bucketOrder: bucketOrderSchema,
+	contextWindow: validator.number().integer().min(1).optional(),
+	selfIdentity: validator.string().min(1).default("assistant"),
+	thoughtSurfacing: validator.string().valid("all-self", "latest-self", "all").default("all-self"),
+	tokenEncoding: tokenEncodingSchema,
+	replayCompatibility: validator.array().items(validator.string().min(1)).default([]),
+	helpers: helpersSchema.optional(),
+	strictToolChoice: validator.boolean().default(false),
+	autoAck: validator.boolean().default(false),
+	unsupportedMediaPolicy: validator.alternatives(validator.string().valid("throw", "fallback-stash", "synthetic-description"), validator.object({
+		mode: validator.string().valid("fallback-stash").required(),
+		stashKeys: validator.array().items(validator.string().min(1)).required()
+	}).unknown(false)).default("throw"),
+	model: validator.string().required(),
+	audio: audioSchema.optional(),
+	frequency_penalty: validator.number().min(-2).max(2).optional(),
+	function_call: functionCallSchema.optional(),
+	functions: validator.array().items(functionsItemSchema).optional(),
+	logit_bias: validator.object().pattern(validator.string(), validator.number()).optional(),
+	logprobs: validator.boolean().optional(),
+	max_completion_tokens: validator.number().integer().min(1).optional(),
+	max_tokens: validator.number().integer().min(1).optional(),
+	metadata: validator.object().pattern(validator.string(), validator.string()).optional(),
+	modalities: validator.array().items(validator.string().valid("text", "audio")).optional(),
+	n: validator.number().integer().min(1).optional(),
+	parallel_tool_calls: validator.boolean().optional(),
+	prediction: predictionSchema.optional(),
+	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(),
+	response_format: responseFormatSchema.optional(),
+	safety_identifier: validator.string().optional(),
+	seed: validator.number().integer().optional(),
+	service_tier: validator.string().valid("auto", "default", "flex", "priority", "scale").optional(),
+	stop: validator.alternatives(validator.string(), validator.array().items(validator.string())).optional(),
+	store: validator.boolean().optional(),
+	stream_options: streamOptionsSchema.optional(),
+	temperature: validator.number().min(0).max(2).optional(),
+	tool_choice: toolChoiceSchema.optional(),
+	top_logprobs: validator.number().integer().min(0).max(20).optional(),
+	top_p: validator.number().min(0).max(1).optional(),
+	user: validator.string().optional(),
+	verbosity: validator.string().valid("low", "medium", "high").optional(),
+	web_search_options: webSearchOptionsSchema.optional()
+}).unknown(false);
+var formatValidationDetails = (err) => err.details.map((d) => d.message).join(" and ");
+/**
+* Validates an arbitrary input against `openAIChatCompletionsOptionsSchema` and returns the
+* resolved options shape. Throws `E_INVALID_OPENAI_CHAT_COMPLETIONS_OPTIONS` (carrying the
+* validator's error report on `cause`) on failure.
+*
+* @param input - The raw options object to validate.
+* @returns The resolved options object with defaults filled in.
+*/
+var validateOptions = (input) => {
+	const { value, error } = openAIChatCompletionsOptionsSchema.validate(input, {
+		abortEarly: false,
+		convert: false
+	});
+	if (error) throw new E_INVALID_OPENAI_CHAT_COMPLETIONS_OPTIONS([formatValidationDetails(error)], { cause: error });
+	return value;
+};
+//#endregion
+export { openAIChatCompletionsOptionsSchema, validateOptions };
+
+//# sourceMappingURL=validation.mjs.map

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

@@ -0,0 +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 { 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    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

@@ -0,0 +1,51 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+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_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;
+exports.E_OPENAI_CHAT_COMPLETIONS_CONTEXT_OVERFLOW = require_batteries_llm_openai_chat_completions_exceptions.E_OPENAI_CHAT_COMPLETIONS_CONTEXT_OVERFLOW;
+exports.E_OPENAI_CHAT_COMPLETIONS_HTTP_ERROR = require_batteries_llm_openai_chat_completions_exceptions.E_OPENAI_CHAT_COMPLETIONS_HTTP_ERROR;
+exports.E_OPENAI_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS = require_batteries_llm_openai_chat_completions_exceptions.E_OPENAI_CHAT_COMPLETIONS_INVALID_TOOL_CALL_ARGS;
+exports.E_OPENAI_CHAT_COMPLETIONS_REQUEST_TIMEOUT = require_batteries_llm_openai_chat_completions_exceptions.E_OPENAI_CHAT_COMPLETIONS_REQUEST_TIMEOUT;
+exports.E_OPENAI_CHAT_COMPLETIONS_STREAM_ERROR = require_batteries_llm_openai_chat_completions_exceptions.E_OPENAI_CHAT_COMPLETIONS_STREAM_ERROR;
+exports.E_OPENAI_CHAT_COMPLETIONS_STREAM_STALLED = require_batteries_llm_openai_chat_completions_exceptions.E_OPENAI_CHAT_COMPLETIONS_STREAM_STALLED;
+exports.OpenAIChatCompletionsAdapter = require_batteries_llm_openai_chat_completions_adapter.OpenAIChatCompletionsAdapter;
+exports.buildChatCompletionsHistory = require_batteries_llm_openai_chat_completions_helpers.buildChatCompletionsHistory;
+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.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.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.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;
+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.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.validateOptions = require_batteries_llm_openai_chat_completions_validation.validateOptions;

package/batteries/llm/openai_chat_completions.mjs

@@ -0,0 +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 { 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 };