@adaptic/lumic-utils 1.0.28 → 1.0.29

package/dist/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var index = require('./index-FqzV71J4.js');
+var index = require('./index-CtY-7qjs.js');
 require('openai');
 require('zod');
 require('@aws-sdk/client-s3');
@@ -60,9 +60,11 @@ exports.JsonParseError = index.JsonParseError;
 exports.LLMCostTracker = index.LLMCostTracker;
 exports.LLMError = index.LLMError;
 exports.LLM_ADVANCED_PROVIDER = index.LLM_ADVANCED_PROVIDER;
+exports.LLM_CRITICAL_PROVIDER = index.LLM_CRITICAL_PROVIDER;
 exports.LLM_DEFAULT_PROVIDER = index.LLM_DEFAULT_PROVIDER;
 exports.LLM_MINI_PROVIDER = index.LLM_MINI_PROVIDER;
 exports.LLM_MODEL_ADVANCED = index.LLM_MODEL_ADVANCED;
+exports.LLM_MODEL_CRITICAL = index.LLM_MODEL_CRITICAL;
 exports.LLM_MODEL_MINI = index.LLM_MODEL_MINI;
 exports.LLM_MODEL_NORMAL = index.LLM_MODEL_NORMAL;
 exports.LLM_NORMAL_PROVIDER = index.LLM_NORMAL_PROVIDER;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/index.mjs

@@ -1,4 +1,4 @@
-export { bW as AWSLambdaError, bX as AWSS3Error, c5 as AWS_LAMBDA_TIMEOUT_MS, c6 as AWS_S3_TIMEOUT_MS, aV as CircuitBreaker, aX as CircuitBreakerOpenError, aW as CircuitBreakerState, aY as DEFAULT_CIRCUIT_BREAKER_CONFIG, c8 as GENERIC_FETCH_TIMEOUT_MS, c3 as GOOGLE_SHEETS_TIMEOUT_MS, bY as GoogleSheetsError, b_ as JsonParseError, b0 as LLMCostTracker, bV as LLMError, bt as LLM_ADVANCED_PROVIDER, bq as LLM_DEFAULT_PROVIDER, br as LLM_MINI_PROVIDER, bx as LLM_MODEL_ADVANCED, bv as LLM_MODEL_MINI, bw as LLM_MODEL_NORMAL, bs as LLM_NORMAL_PROVIDER, bu as LLM_PROVIDER, c4 as LLM_TIMEOUT_MS, bT as LumicError, bn as MODEL_ALIASES, bo as OPENAI_COMPATIBLE_PROVIDERS, c7 as OPENWEATHER_TIMEOUT_MS, b$ as PDFError, c2 as PERPLEXITY_TIMEOUT_MS, bp as PROVIDER_DEFAULT_MODELS, bZ as PerplexityError, be as RATE_LIMIT_PROFILES, c1 as SLACK_TIMEOUT_MS, bj as SUPPORTED_MODELS, bU as SlackError, bd as TokenBucketRateLimiter, c0 as ZipError, bi as checkIntegrationHealth, bS as createSafeValidator, bR as createValidator, b8 as generateCorrelationId, ba as getCorrelationContext, bc as getCorrelationHeaders, b9 as getCorrelationId, b1 as getLLMCostTracker, aM as getLumicLogger, b5 as getMetricsCollector, bl as getModelCapabilities, bm as getModelProvider, bf as getRateLimiter, aR as getSecrets, bH as googleSheetsValueRangeSchema, bk as isValidModel, bM as lambdaInvokeResponseSchema, l as lumic, by as makeAnthropicCall, bz as makeOpenAICompatibleCall, bA as openAIChatCompletionSchema, bB as openAIImageResponseSchema, bE as perplexityResponseSchema, aT as requireSecret, bg as resetAllRateLimiters, b3 as resetLLMCostTracker, b6 as resetMetricsCollector, aS as resetSecrets, bL as s3GetObjectSchema, bK as s3ListObjectsSchema, bJ as safeValidateGoogleSheetsResponse, bQ as safeValidateLambdaResponse, bD as safeValidateOpenAIChatCompletion, bG as safeValidatePerplexityResponse, bO as safeValidateS3ListObjects, aP as sanitizeAWSAuth, aO as sanitizeError, aN as sanitizeForLog, aQ as sanitizeObject, b2 as setLLMCostTracker, aL as setLumicLogger, b4 as setMetricsCollector, a$ as validateGoogleSheetsRange, bI as validateGoogleSheetsResponse, bP as validateLambdaResponse, bC as validateOpenAIChatCompletion, bF as validatePerplexityResponse, a_ as validateS3Key, bN as validateS3ListObjects, aZ as validateSlackChannel, bb as withCorrelationId, b7 as withMetrics, bh as withRateLimit, aU as withRetry } from './index-I-0uzUiF.js';
+export { bY as AWSLambdaError, bZ as AWSS3Error, c7 as AWS_LAMBDA_TIMEOUT_MS, c8 as AWS_S3_TIMEOUT_MS, aV as CircuitBreaker, aX as CircuitBreakerOpenError, aW as CircuitBreakerState, aY as DEFAULT_CIRCUIT_BREAKER_CONFIG, ca as GENERIC_FETCH_TIMEOUT_MS, c5 as GOOGLE_SHEETS_TIMEOUT_MS, b_ as GoogleSheetsError, c0 as JsonParseError, b0 as LLMCostTracker, bX as LLMError, bt as LLM_ADVANCED_PROVIDER, bu as LLM_CRITICAL_PROVIDER, bq as LLM_DEFAULT_PROVIDER, br as LLM_MINI_PROVIDER, by as LLM_MODEL_ADVANCED, bz as LLM_MODEL_CRITICAL, bw as LLM_MODEL_MINI, bx as LLM_MODEL_NORMAL, bs as LLM_NORMAL_PROVIDER, bv as LLM_PROVIDER, c6 as LLM_TIMEOUT_MS, bV as LumicError, bn as MODEL_ALIASES, bo as OPENAI_COMPATIBLE_PROVIDERS, c9 as OPENWEATHER_TIMEOUT_MS, c1 as PDFError, c4 as PERPLEXITY_TIMEOUT_MS, bp as PROVIDER_DEFAULT_MODELS, b$ as PerplexityError, be as RATE_LIMIT_PROFILES, c3 as SLACK_TIMEOUT_MS, bj as SUPPORTED_MODELS, bW as SlackError, bd as TokenBucketRateLimiter, c2 as ZipError, bi as checkIntegrationHealth, bU as createSafeValidator, bT as createValidator, b8 as generateCorrelationId, ba as getCorrelationContext, bc as getCorrelationHeaders, b9 as getCorrelationId, b1 as getLLMCostTracker, aM as getLumicLogger, b5 as getMetricsCollector, bl as getModelCapabilities, bm as getModelProvider, bf as getRateLimiter, aR as getSecrets, bJ as googleSheetsValueRangeSchema, bk as isValidModel, bO as lambdaInvokeResponseSchema, l as lumic, bA as makeAnthropicCall, bB as makeOpenAICompatibleCall, bC as openAIChatCompletionSchema, bD as openAIImageResponseSchema, bG as perplexityResponseSchema, aT as requireSecret, bg as resetAllRateLimiters, b3 as resetLLMCostTracker, b6 as resetMetricsCollector, aS as resetSecrets, bN as s3GetObjectSchema, bM as s3ListObjectsSchema, bL as safeValidateGoogleSheetsResponse, bS as safeValidateLambdaResponse, bF as safeValidateOpenAIChatCompletion, bI as safeValidatePerplexityResponse, bQ as safeValidateS3ListObjects, aP as sanitizeAWSAuth, aO as sanitizeError, aN as sanitizeForLog, aQ as sanitizeObject, b2 as setLLMCostTracker, aL as setLumicLogger, b4 as setMetricsCollector, a$ as validateGoogleSheetsRange, bK as validateGoogleSheetsResponse, bR as validateLambdaResponse, bE as validateOpenAIChatCompletion, bH as validatePerplexityResponse, a_ as validateS3Key, bP as validateS3ListObjects, aZ as validateSlackChannel, bb as withCorrelationId, b7 as withMetrics, bh as withRateLimit, aU as withRetry } from './index-CV8HlDp8.js';
 import 'openai';
 import 'zod';
 import '@aws-sdk/client-s3';

package/dist/test.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var index = require('./index-FqzV71J4.js');
+var index = require('./index-CtY-7qjs.js');
 require('openai');
 require('zod');
 require('@aws-sdk/client-s3');

package/dist/test.mjs

@@ -1,4 +1,4 @@
-import { l as lumic } from './index-I-0uzUiF.js';
+import { l as lumic } from './index-CV8HlDp8.js';
 import 'openai';
 import 'zod';
 import '@aws-sdk/client-s3';

package/dist/types/config/secrets.d.ts

@@ -117,9 +117,11 @@ declare const lumicSecretsSchema: z.ZodObject<{
         llmMiniProvider: z.ZodOptional<z.ZodString>;
         llmNormalProvider: z.ZodOptional<z.ZodString>;
         llmAdvancedProvider: z.ZodOptional<z.ZodString>;
+        llmCriticalProvider: z.ZodOptional<z.ZodString>;
         llmModelMini: z.ZodOptional<z.ZodString>;
         llmModelNormal: z.ZodOptional<z.ZodString>;
         llmModelAdvanced: z.ZodOptional<z.ZodString>;
+        llmModelCritical: z.ZodOptional<z.ZodString>;
         lumicDebug: z.ZodDefault<z.ZodBoolean>;
         allowedUploadPaths: z.ZodDefault<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
@@ -131,9 +133,11 @@ declare const lumicSecretsSchema: z.ZodObject<{
         llmMiniProvider?: string | undefined;
         llmNormalProvider?: string | undefined;
         llmAdvancedProvider?: string | undefined;
+        llmCriticalProvider?: string | undefined;
         llmModelMini?: string | undefined;
         llmModelNormal?: string | undefined;
         llmModelAdvanced?: string | undefined;
+        llmModelCritical?: string | undefined;
     }, {
         aiModel?: string | undefined;
         perplexityModel?: string | undefined;
@@ -141,9 +145,11 @@ declare const lumicSecretsSchema: z.ZodObject<{
         llmMiniProvider?: string | undefined;
         llmNormalProvider?: string | undefined;
         llmAdvancedProvider?: string | undefined;
+        llmCriticalProvider?: string | undefined;
         llmModelMini?: string | undefined;
         llmModelNormal?: string | undefined;
         llmModelAdvanced?: string | undefined;
+        llmModelCritical?: string | undefined;
         lumicDebug?: boolean | undefined;
         allowedUploadPaths?: string | undefined;
     }>;
@@ -200,9 +206,11 @@ declare const lumicSecretsSchema: z.ZodObject<{
         llmMiniProvider?: string | undefined;
         llmNormalProvider?: string | undefined;
         llmAdvancedProvider?: string | undefined;
+        llmCriticalProvider?: string | undefined;
         llmModelMini?: string | undefined;
         llmModelNormal?: string | undefined;
         llmModelAdvanced?: string | undefined;
+        llmModelCritical?: string | undefined;
     };
 }, {
     openai: {
@@ -255,9 +263,11 @@ declare const lumicSecretsSchema: z.ZodObject<{
         llmMiniProvider?: string | undefined;
         llmNormalProvider?: string | undefined;
         llmAdvancedProvider?: string | undefined;
+        llmCriticalProvider?: string | undefined;
         llmModelMini?: string | undefined;
         llmModelNormal?: string | undefined;
         llmModelAdvanced?: string | undefined;
+        llmModelCritical?: string | undefined;
         lumicDebug?: boolean | undefined;
         allowedUploadPaths?: string | undefined;
     };

package/dist/types/functions/__tests__/gpt56-model-release-layer.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/functions/__tests__/llm-openai-responses-routing.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/functions/llm-config.d.ts

@@ -7,13 +7,15 @@ interface AIModelCosts {
     };
 }
 /**
- * Token costs in USD per token. Last updated May 2026.
+ * Token costs in USD per token. Last updated July 2026.
  *
- * `cacheHitCost` reflects OpenAI's cached-input billing rate (~50% of the
- * standard input rate per OpenAI's prompt caching documentation). When set,
- * `calculateCost` splits prompt tokens into cached vs non-cached buckets and
- * applies the discount; when omitted, cached tokens are billed at full input
- * rate (a silent ~50% cost overstatement for cache-friendly workloads).
+ * `cacheHitCost` reflects each model's cached-input billing rate. For most
+ * models this is ~50% of the standard input rate (per OpenAI's prompt-caching
+ * documentation); the GPT-5.6 reasoning trio discounts cached input more
+ * aggressively, to 10% of the input rate. When set, `calculateCost` splits
+ * prompt tokens into cached vs non-cached buckets and applies the discount; when
+ * omitted, cached tokens are billed at the full input rate (a silent cost
+ * overstatement for cache-friendly workloads).
  */
 export declare const openAiModelCosts: AIModelCosts;
 export declare const anthropicModelCosts: AIModelCosts;

package/dist/types/functions/llm-openai.d.ts

@@ -1,6 +1,43 @@
 import { ChatCompletionContentPart } from 'openai/resources/chat';
-import { LLMResponse, LLMOptions, OpenAIResponseFormat } from '../types';
-import { ResponseCreateParamsNonStreaming } from 'openai/resources/responses/responses';
+import { LLMResponse, LLMOptions, OpenAIModel, OpenAIResponseFormat } from '../types';
+import { ResponseCreateParamsNonStreaming, Response as OpenAIResponse } from 'openai/resources/responses/responses';
+/**
+ * Provider-agnostic completion shape produced by BOTH OpenAI transports (Chat
+ * Completions and Responses). `makeOpenAIChatCompletionCall` builds its
+ * {@link LLMResponse} envelope from this shape, so keeping the two producers
+ * ({@link createCompletion} and the Responses normalizer) emitting an identical
+ * `CompletionResponse` is what guarantees a byte-identical caller-facing result
+ * regardless of which OpenAI endpoint served the request.
+ */
+export interface CompletionResponse {
+    id: string;
+    content: string;
+    tool_calls?: Array<{
+        id: string;
+        type: 'function';
+        function: {
+            name: string;
+            arguments: string;
+        };
+    }>;
+    usage: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+        cached_tokens: number;
+        /**
+         * Reasoning tokens billed at the output rate. Always 0 on the Chat
+         * Completions path (non-reasoning models). Populated from the Responses
+         * API's `output_tokens_details.reasoning_tokens` when a reasoning model is
+         * routed to the Responses transport so cost tracking stays accurate.
+         */
+        reasoning_tokens: number;
+    };
+    system_fingerprint?: string;
+    service_tier?: string;
+    provider: string;
+    model: OpenAIModel;
+}
 export declare const DEFAULT_OPTIONS: LLMOptions;
 /**
  * Checks if the given model supports the temperature parameter. Reasoning models (o1*, o3*, o4*) do not support temperature.
@@ -14,9 +51,95 @@ export declare function supportsTemperature(model: string): boolean;
  * @returns True if the model is a reasoning model, false otherwise.
  */
 export declare function isReasoningModel(model: string): boolean;
+/**
+ * Checks whether a model must use the OpenAI Responses API (`/v1/responses`)
+ * for function-tool calls rather than Chat Completions (`/v1/chat/completions`).
+ *
+ * Driven entirely by the {@link ModelCapabilities.requiresResponsesApiForTools}
+ * flag in the model registry — there are no hardcoded model-name checks here.
+ * Unknown models and models without the flag return `false` (stay on Chat
+ * Completions).
+ *
+ * @param model The model to check.
+ * @returns True when tool-bearing calls for this model must be routed to the
+ *   Responses API, false otherwise.
+ */
+export declare function requiresResponsesApiForTools(model: string): boolean;
+/**
+ * Builds an OpenAI Responses API request body from the exact same arguments a
+ * caller passes to {@link makeOpenAIChatCompletionCall}. This is the request
+ * half of the transparent routing layer.
+ *
+ * The mapping deliberately mirrors {@link createCompletion}'s Chat request
+ * one-for-one so request semantics are preserved across transports:
+ * - `developerPrompt` (+ context messages + user `content`) → `input` items
+ *   (chat `tool_calls`/`tool` messages become `function_call`/
+ *   `function_call_output` items).
+ * - chat `tools` → Responses `tools` (function tools only).
+ * - `temperature` → `temperature`, gated by {@link supportsTemperature} exactly
+ *   as the Chat path (dropped for GPT-5.6/o-series reasoning models).
+ * - `max_completion_tokens` → `max_output_tokens`.
+ * - {@link OpenAIResponseFormat} → `text.format`.
+ * - `reasoning_effort` → `reasoning.effort`, clamped per-model via
+ *   {@link clampReasoningEffort} and gated on {@link isReasoningModel} exactly as
+ *   the Chat path, so the two transports clamp identically. Only set when the
+ *   caller explicitly supplies it — parity is preserved for callers (like the
+ *   engine decision path) that do not.
+ *
+ * Parameters the Chat path does not forward (`top_p`, `parallel_tool_calls`,
+ * `tool_choice`, `metadata`, `store`) are intentionally omitted here too, so the
+ * request semantics stay identical to today's production Chat behaviour.
+ *
+ * @param content The user content (string or multi-modal content parts).
+ * @param responseFormat The desired response format.
+ * @param options The Chat-Completions-style options bag.
+ * @param normalizedModel The normalized model name to target.
+ * @returns A ready-to-send non-streaming Responses API request body.
+ * @throws Error when a `json_schema` format is requested for an incompatible model.
+ */
+export declare function buildResponsesRequestFromChatOptions(content: string | ChatCompletionContentPart[], responseFormat: OpenAIResponseFormat, options: LLMOptions, normalizedModel: string): ResponseCreateParamsNonStreaming;
+/**
+ * Normalizes an OpenAI Responses API result into the internal
+ * {@link CompletionResponse} shape. This is the response half of the
+ * transparent routing layer and is the single most correctness-critical mapping
+ * in this module: the returned `tool_calls` MUST be byte-identical to what the
+ * Chat path produces so downstream consumers (notably the engine decision path,
+ * which reads `tool_call.function.arguments` as a JSON string) parse it
+ * unchanged.
+ *
+ * Mapping:
+ * - `function_call` output items → `{ id: call_id, type:'function',
+ *   function:{ name, arguments } }` with `arguments` kept as the raw JSON
+ *   string (never pre-parsed) — exactly the Chat `ChatCompletionMessageToolCall`
+ *   shape. `id` is sourced from `call_id` (not the item `id`) so it round-trips
+ *   as the `tool_call_id` in a multi-turn conversation.
+ * - `message` output items → concatenated `output_text` parts (refusals and
+ *   non-text parts contribute nothing, matching the Chat path's null-content →
+ *   empty-string behaviour).
+ * - usage: `input_tokens`→prompt, `output_tokens`→completion,
+ *   `input_tokens_details.cached_tokens`→cached,
+ *   `output_tokens_details.reasoning_tokens`→reasoning.
+ *
+ * `system_fingerprint` is `undefined` — the Responses API does not return one
+ * (the Chat path forwards it; consumers already treat it as optional).
+ *
+ * @param response The raw OpenAI Responses API result.
+ * @param normalizedModel The normalized model name the request targeted.
+ * @param serviceTier The caller's requested service tier, echoed through as on
+ *   the Chat path.
+ * @returns A {@link CompletionResponse} structurally identical to the Chat path's.
+ */
+export declare function normalizeResponsesToCompletion(response: OpenAIResponse, normalizedModel: string, serviceTier?: string): CompletionResponse;
 /**
  * Makes a call to the Lumic LLM interface, either to the default model or to one specified.
  *
+ * Transport is chosen transparently: models flagged
+ * {@link ModelCapabilities.requiresResponsesApiForTools} (the GPT-5.6 reasoning
+ * trio) that are called WITH function tools are routed to the OpenAI Responses
+ * API; every other call stays on Chat Completions. The returned
+ * {@link LLMResponse} envelope — `response`, `tool_calls`, and `usage` — is
+ * byte-identical across both transports, so callers require no changes.
+ *
  * @param content The content to pass to the LLM.
  * @param responseFormat The format of the response. Defaults to 'text'.
  * @param options The options for the LLM call. Defaults to an empty object.

package/dist/types/index.d.ts

@@ -43,7 +43,7 @@ export { ParseJsonOptions } from './functions/llm-utils';
 export { FixJsonWithAIOptions } from './functions/json-llm-tools';
 export { SUPPORTED_MODELS, isValidModel, getModelCapabilities, getModelProvider, MODEL_ALIASES, OPENAI_COMPATIBLE_PROVIDERS, PROVIDER_DEFAULT_MODELS, } from './types/openai-types';
 export type { SupportedModel, OpenAIModel, AnthropicModel, DeepseekModel, KimiModel, QwenModel, XAIModel, GeminiModel, LLMModel, LLMProvider, ModelCapabilities, OpenAICompatibleProviderConfig, } from './types/openai-types';
-export { LLM_DEFAULT_PROVIDER, LLM_MINI_PROVIDER, LLM_NORMAL_PROVIDER, LLM_ADVANCED_PROVIDER, LLM_PROVIDER, LLM_MODEL_MINI, LLM_MODEL_NORMAL, LLM_MODEL_ADVANCED, } from './utils/config';
+export { LLM_DEFAULT_PROVIDER, LLM_MINI_PROVIDER, LLM_NORMAL_PROVIDER, LLM_ADVANCED_PROVIDER, LLM_CRITICAL_PROVIDER, LLM_PROVIDER, LLM_MODEL_MINI, LLM_MODEL_NORMAL, LLM_MODEL_ADVANCED, LLM_MODEL_CRITICAL, } from './utils/config';
 export { makeAnthropicCall } from './functions/llm-anthropic';
 export { makeOpenAICompatibleCall } from './functions/llm-openai-compatible';
 export { openAIChatCompletionSchema, openAIImageResponseSchema, validateOpenAIChatCompletion, safeValidateOpenAIChatCompletion, perplexityResponseSchema, validatePerplexityResponse, safeValidatePerplexityResponse, googleSheetsValueRangeSchema, validateGoogleSheetsResponse, safeValidateGoogleSheetsResponse, s3ListObjectsSchema, s3GetObjectSchema, lambdaInvokeResponseSchema, validateS3ListObjects, safeValidateS3ListObjects, validateLambdaResponse, safeValidateLambdaResponse, createValidator, createSafeValidator, } from './schemas';

package/dist/types/schemas/openai-schemas.d.ts

@@ -44,8 +44,8 @@ export declare const openAIChatCompletionSchema: z.ZodObject<{
             }>, "many">>;
             refusal: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, "strip", z.ZodTypeAny, {
-            content: string | null;
             role: "function" | "system" | "user" | "assistant" | "tool";
+            content: string | null;
             tool_calls?: {
                 function: {
                     name: string;
@@ -56,8 +56,8 @@ export declare const openAIChatCompletionSchema: z.ZodObject<{
             }[] | undefined;
             refusal?: string | null | undefined;
         }, {
-            content: string | null;
             role: "function" | "system" | "user" | "assistant" | "tool";
+            content: string | null;
             tool_calls?: {
                 function: {
                     name: string;
@@ -71,8 +71,8 @@ export declare const openAIChatCompletionSchema: z.ZodObject<{
         finish_reason: z.ZodNullable<z.ZodEnum<["stop", "length", "tool_calls", "content_filter", "function_call"]>>;
     }, "strip", z.ZodTypeAny, {
         message: {
-            content: string | null;
             role: "function" | "system" | "user" | "assistant" | "tool";
+            content: string | null;
             tool_calls?: {
                 function: {
                     name: string;
@@ -84,11 +84,11 @@ export declare const openAIChatCompletionSchema: z.ZodObject<{
             refusal?: string | null | undefined;
         };
         index: number;
-        finish_reason: "length" | "tool_calls" | "function_call" | "stop" | "content_filter" | null;
+        finish_reason: "length" | "function_call" | "tool_calls" | "stop" | "content_filter" | null;
     }, {
         message: {
-            content: string | null;
             role: "function" | "system" | "user" | "assistant" | "tool";
+            content: string | null;
             tool_calls?: {
                 function: {
                     name: string;
@@ -100,7 +100,7 @@ export declare const openAIChatCompletionSchema: z.ZodObject<{
             refusal?: string | null | undefined;
         };
         index: number;
-        finish_reason: "length" | "tool_calls" | "function_call" | "stop" | "content_filter" | null;
+        finish_reason: "length" | "function_call" | "tool_calls" | "stop" | "content_filter" | null;
     }>, "many">;
     usage: z.ZodOptional<z.ZodObject<{
         prompt_tokens: z.ZodNumber;
@@ -198,8 +198,8 @@ export declare const openAIChatCompletionSchema: z.ZodObject<{
             }>, "many">>;
             refusal: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, "strip", z.ZodTypeAny, {
-            content: string | null;
             role: "function" | "system" | "user" | "assistant" | "tool";
+            content: string | null;
             tool_calls?: {
                 function: {
                     name: string;
@@ -210,8 +210,8 @@ export declare const openAIChatCompletionSchema: z.ZodObject<{
             }[] | undefined;
             refusal?: string | null | undefined;
         }, {
-            content: string | null;
             role: "function" | "system" | "user" | "assistant" | "tool";
+            content: string | null;
             tool_calls?: {
                 function: {
                     name: string;
@@ -225,8 +225,8 @@ export declare const openAIChatCompletionSchema: z.ZodObject<{
         finish_reason: z.ZodNullable<z.ZodEnum<["stop", "length", "tool_calls", "content_filter", "function_call"]>>;
     }, "strip", z.ZodTypeAny, {
         message: {
-            content: string | null;
             role: "function" | "system" | "user" | "assistant" | "tool";
+            content: string | null;
             tool_calls?: {
                 function: {
                     name: string;
@@ -238,11 +238,11 @@ export declare const openAIChatCompletionSchema: z.ZodObject<{
             refusal?: string | null | undefined;
         };
         index: number;
-        finish_reason: "length" | "tool_calls" | "function_call" | "stop" | "content_filter" | null;
+        finish_reason: "length" | "function_call" | "tool_calls" | "stop" | "content_filter" | null;
     }, {
         message: {
-            content: string | null;
             role: "function" | "system" | "user" | "assistant" | "tool";
+            content: string | null;
             tool_calls?: {
                 function: {
                     name: string;
@@ -254,7 +254,7 @@ export declare const openAIChatCompletionSchema: z.ZodObject<{
             refusal?: string | null | undefined;
         };
         index: number;
-        finish_reason: "length" | "tool_calls" | "function_call" | "stop" | "content_filter" | null;
+        finish_reason: "length" | "function_call" | "tool_calls" | "stop" | "content_filter" | null;
     }>, "many">;
     usage: z.ZodOptional<z.ZodObject<{
         prompt_tokens: z.ZodNumber;
@@ -352,8 +352,8 @@ export declare const openAIChatCompletionSchema: z.ZodObject<{
             }>, "many">>;
             refusal: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, "strip", z.ZodTypeAny, {
-            content: string | null;
             role: "function" | "system" | "user" | "assistant" | "tool";
+            content: string | null;
             tool_calls?: {
                 function: {
                     name: string;
@@ -364,8 +364,8 @@ export declare const openAIChatCompletionSchema: z.ZodObject<{
             }[] | undefined;
             refusal?: string | null | undefined;
         }, {
-            content: string | null;
             role: "function" | "system" | "user" | "assistant" | "tool";
+            content: string | null;
             tool_calls?: {
                 function: {
                     name: string;
@@ -379,8 +379,8 @@ export declare const openAIChatCompletionSchema: z.ZodObject<{
         finish_reason: z.ZodNullable<z.ZodEnum<["stop", "length", "tool_calls", "content_filter", "function_call"]>>;
     }, "strip", z.ZodTypeAny, {
         message: {
-            content: string | null;
             role: "function" | "system" | "user" | "assistant" | "tool";
+            content: string | null;
             tool_calls?: {
                 function: {
                     name: string;
@@ -392,11 +392,11 @@ export declare const openAIChatCompletionSchema: z.ZodObject<{
             refusal?: string | null | undefined;
         };
         index: number;
-        finish_reason: "length" | "tool_calls" | "function_call" | "stop" | "content_filter" | null;
+        finish_reason: "length" | "function_call" | "tool_calls" | "stop" | "content_filter" | null;
     }, {
         message: {
-            content: string | null;
             role: "function" | "system" | "user" | "assistant" | "tool";
+            content: string | null;
             tool_calls?: {
                 function: {
                     name: string;
@@ -408,7 +408,7 @@ export declare const openAIChatCompletionSchema: z.ZodObject<{
             refusal?: string | null | undefined;
         };
         index: number;
-        finish_reason: "length" | "tool_calls" | "function_call" | "stop" | "content_filter" | null;
+        finish_reason: "length" | "function_call" | "tool_calls" | "stop" | "content_filter" | null;
     }>, "many">;
     usage: z.ZodOptional<z.ZodObject<{
         prompt_tokens: z.ZodNumber;
@@ -561,8 +561,8 @@ export declare const validateOpenAIChatCompletion: (data: unknown) => z.objectIn
             }>, "many">>;
             refusal: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, "strip", z.ZodTypeAny, {
-            content: string | null;
             role: "function" | "system" | "user" | "assistant" | "tool";
+            content: string | null;
             tool_calls?: {
                 function: {
                     name: string;
@@ -573,8 +573,8 @@ export declare const validateOpenAIChatCompletion: (data: unknown) => z.objectIn
             }[] | undefined;
             refusal?: string | null | undefined;
         }, {
-            content: string | null;
             role: "function" | "system" | "user" | "assistant" | "tool";
+            content: string | null;
             tool_calls?: {
                 function: {
                     name: string;
@@ -588,8 +588,8 @@ export declare const validateOpenAIChatCompletion: (data: unknown) => z.objectIn
         finish_reason: z.ZodNullable<z.ZodEnum<["stop", "length", "tool_calls", "content_filter", "function_call"]>>;
     }, "strip", z.ZodTypeAny, {
         message: {
-            content: string | null;
             role: "function" | "system" | "user" | "assistant" | "tool";
+            content: string | null;
             tool_calls?: {
                 function: {
                     name: string;
@@ -601,11 +601,11 @@ export declare const validateOpenAIChatCompletion: (data: unknown) => z.objectIn
             refusal?: string | null | undefined;
         };
         index: number;
-        finish_reason: "length" | "tool_calls" | "function_call" | "stop" | "content_filter" | null;
+        finish_reason: "length" | "function_call" | "tool_calls" | "stop" | "content_filter" | null;
     }, {
         message: {
-            content: string | null;
             role: "function" | "system" | "user" | "assistant" | "tool";
+            content: string | null;
             tool_calls?: {
                 function: {
                     name: string;
@@ -617,7 +617,7 @@ export declare const validateOpenAIChatCompletion: (data: unknown) => z.objectIn
             refusal?: string | null | undefined;
         };
         index: number;
-        finish_reason: "length" | "tool_calls" | "function_call" | "stop" | "content_filter" | null;
+        finish_reason: "length" | "function_call" | "tool_calls" | "stop" | "content_filter" | null;
     }>, "many">;
     usage: z.ZodOptional<z.ZodObject<{
         prompt_tokens: z.ZodNumber;
@@ -717,8 +717,8 @@ export declare const safeValidateOpenAIChatCompletion: (data: unknown) => import
             }>, "many">>;
             refusal: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, "strip", z.ZodTypeAny, {
-            content: string | null;
             role: "function" | "system" | "user" | "assistant" | "tool";
+            content: string | null;
             tool_calls?: {
                 function: {
                     name: string;
@@ -729,8 +729,8 @@ export declare const safeValidateOpenAIChatCompletion: (data: unknown) => import
             }[] | undefined;
             refusal?: string | null | undefined;
         }, {
-            content: string | null;
             role: "function" | "system" | "user" | "assistant" | "tool";
+            content: string | null;
             tool_calls?: {
                 function: {
                     name: string;
@@ -744,8 +744,8 @@ export declare const safeValidateOpenAIChatCompletion: (data: unknown) => import
         finish_reason: z.ZodNullable<z.ZodEnum<["stop", "length", "tool_calls", "content_filter", "function_call"]>>;
     }, "strip", z.ZodTypeAny, {
         message: {
-            content: string | null;
             role: "function" | "system" | "user" | "assistant" | "tool";
+            content: string | null;
             tool_calls?: {
                 function: {
                     name: string;
@@ -757,11 +757,11 @@ export declare const safeValidateOpenAIChatCompletion: (data: unknown) => import
             refusal?: string | null | undefined;
         };
         index: number;
-        finish_reason: "length" | "tool_calls" | "function_call" | "stop" | "content_filter" | null;
+        finish_reason: "length" | "function_call" | "tool_calls" | "stop" | "content_filter" | null;
     }, {
         message: {
-            content: string | null;
             role: "function" | "system" | "user" | "assistant" | "tool";
+            content: string | null;
             tool_calls?: {
                 function: {
                     name: string;
@@ -773,7 +773,7 @@ export declare const safeValidateOpenAIChatCompletion: (data: unknown) => import
             refusal?: string | null | undefined;
         };
         index: number;
-        finish_reason: "length" | "tool_calls" | "function_call" | "stop" | "content_filter" | null;
+        finish_reason: "length" | "function_call" | "tool_calls" | "stop" | "content_filter" | null;
     }>, "many">;
     usage: z.ZodOptional<z.ZodObject<{
         prompt_tokens: z.ZodNumber;