@adaptic/lumic-utils 1.0.28 → 1.0.29

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

@@ -16,43 +16,43 @@ export declare const perplexityResponseSchema: z.ZodObject<{
             role: z.ZodEnum<["assistant"]>;
             content: z.ZodString;
         }, "strip", z.ZodTypeAny, {
-            content: string;
             role: "assistant";
-        }, {
             content: string;
+        }, {
             role: "assistant";
+            content: string;
         }>;
         delta: z.ZodOptional<z.ZodObject<{
             role: z.ZodOptional<z.ZodString>;
             content: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
-            content?: string | undefined;
             role?: string | undefined;
-        }, {
             content?: string | undefined;
+        }, {
             role?: string | undefined;
+            content?: string | undefined;
         }>>;
     }, "strip", z.ZodTypeAny, {
         message: {
-            content: string;
             role: "assistant";
+            content: string;
         };
         index: number;
         finish_reason: "length" | "stop" | "model_length" | null;
         delta?: {
-            content?: string | undefined;
             role?: string | undefined;
+            content?: string | undefined;
         } | undefined;
     }, {
         message: {
-            content: string;
             role: "assistant";
+            content: string;
         };
         index: number;
         finish_reason: "length" | "stop" | "model_length" | null;
         delta?: {
-            content?: string | undefined;
             role?: string | undefined;
+            content?: string | undefined;
         } | undefined;
     }>, "many">;
     usage: z.ZodOptional<z.ZodObject<{
@@ -81,43 +81,43 @@ export declare const perplexityResponseSchema: z.ZodObject<{
             role: z.ZodEnum<["assistant"]>;
             content: z.ZodString;
         }, "strip", z.ZodTypeAny, {
-            content: string;
             role: "assistant";
-        }, {
             content: string;
+        }, {
             role: "assistant";
+            content: string;
         }>;
         delta: z.ZodOptional<z.ZodObject<{
             role: z.ZodOptional<z.ZodString>;
             content: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
-            content?: string | undefined;
             role?: string | undefined;
-        }, {
             content?: string | undefined;
+        }, {
             role?: string | undefined;
+            content?: string | undefined;
         }>>;
     }, "strip", z.ZodTypeAny, {
         message: {
-            content: string;
             role: "assistant";
+            content: string;
         };
         index: number;
         finish_reason: "length" | "stop" | "model_length" | null;
         delta?: {
-            content?: string | undefined;
             role?: string | undefined;
+            content?: string | undefined;
         } | undefined;
     }, {
         message: {
-            content: string;
             role: "assistant";
+            content: string;
         };
         index: number;
         finish_reason: "length" | "stop" | "model_length" | null;
         delta?: {
-            content?: string | undefined;
             role?: string | undefined;
+            content?: string | undefined;
         } | undefined;
     }>, "many">;
     usage: z.ZodOptional<z.ZodObject<{
@@ -146,43 +146,43 @@ export declare const perplexityResponseSchema: z.ZodObject<{
             role: z.ZodEnum<["assistant"]>;
             content: z.ZodString;
         }, "strip", z.ZodTypeAny, {
-            content: string;
             role: "assistant";
-        }, {
             content: string;
+        }, {
             role: "assistant";
+            content: string;
         }>;
         delta: z.ZodOptional<z.ZodObject<{
             role: z.ZodOptional<z.ZodString>;
             content: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
-            content?: string | undefined;
             role?: string | undefined;
-        }, {
             content?: string | undefined;
+        }, {
             role?: string | undefined;
+            content?: string | undefined;
         }>>;
     }, "strip", z.ZodTypeAny, {
         message: {
-            content: string;
             role: "assistant";
+            content: string;
         };
         index: number;
         finish_reason: "length" | "stop" | "model_length" | null;
         delta?: {
-            content?: string | undefined;
             role?: string | undefined;
+            content?: string | undefined;
         } | undefined;
     }, {
         message: {
-            content: string;
             role: "assistant";
+            content: string;
         };
         index: number;
         finish_reason: "length" | "stop" | "model_length" | null;
         delta?: {
-            content?: string | undefined;
             role?: string | undefined;
+            content?: string | undefined;
         } | undefined;
     }>, "many">;
     usage: z.ZodOptional<z.ZodObject<{
@@ -215,43 +215,43 @@ export declare const validatePerplexityResponse: (data: unknown) => z.objectInpu
             role: z.ZodEnum<["assistant"]>;
             content: z.ZodString;
         }, "strip", z.ZodTypeAny, {
-            content: string;
             role: "assistant";
-        }, {
             content: string;
+        }, {
             role: "assistant";
+            content: string;
         }>;
         delta: z.ZodOptional<z.ZodObject<{
             role: z.ZodOptional<z.ZodString>;
             content: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
-            content?: string | undefined;
             role?: string | undefined;
-        }, {
             content?: string | undefined;
+        }, {
             role?: string | undefined;
+            content?: string | undefined;
         }>>;
     }, "strip", z.ZodTypeAny, {
         message: {
-            content: string;
             role: "assistant";
+            content: string;
         };
         index: number;
         finish_reason: "length" | "stop" | "model_length" | null;
         delta?: {
-            content?: string | undefined;
             role?: string | undefined;
+            content?: string | undefined;
         } | undefined;
     }, {
         message: {
-            content: string;
             role: "assistant";
+            content: string;
         };
         index: number;
         finish_reason: "length" | "stop" | "model_length" | null;
         delta?: {
-            content?: string | undefined;
             role?: string | undefined;
+            content?: string | undefined;
         } | undefined;
     }>, "many">;
     usage: z.ZodOptional<z.ZodObject<{
@@ -282,43 +282,43 @@ export declare const safeValidatePerplexityResponse: (data: unknown) => import("
             role: z.ZodEnum<["assistant"]>;
             content: z.ZodString;
         }, "strip", z.ZodTypeAny, {
-            content: string;
             role: "assistant";
-        }, {
             content: string;
+        }, {
             role: "assistant";
+            content: string;
         }>;
         delta: z.ZodOptional<z.ZodObject<{
             role: z.ZodOptional<z.ZodString>;
             content: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
-            content?: string | undefined;
             role?: string | undefined;
-        }, {
             content?: string | undefined;
+        }, {
             role?: string | undefined;
+            content?: string | undefined;
         }>>;
     }, "strip", z.ZodTypeAny, {
         message: {
-            content: string;
             role: "assistant";
+            content: string;
         };
         index: number;
         finish_reason: "length" | "stop" | "model_length" | null;
         delta?: {
-            content?: string | undefined;
             role?: string | undefined;
+            content?: string | undefined;
         } | undefined;
     }, {
         message: {
-            content: string;
             role: "assistant";
+            content: string;
         };
         index: number;
         finish_reason: "length" | "stop" | "model_length" | null;
         delta?: {
-            content?: string | undefined;
             role?: string | undefined;
+            content?: string | undefined;
         } | undefined;
     }>, "many">;
     usage: z.ZodOptional<z.ZodObject<{

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

@@ -15,6 +15,26 @@ export interface ModelCapabilities {
     supportsDeveloperPrompt: boolean;
     supportsTemperature: boolean;
     isReasoningModel: boolean;
+    /**
+     * When `true`, function tools MUST be sent via the OpenAI Responses API
+     * (`/v1/responses`) rather than Chat Completions (`/v1/chat/completions`).
+     *
+     * OpenAI's GPT-5.6 reasoning trio (sol/terra/luna) returns HTTP 400
+     * ("Function tools with reasoning_effort are not supported for gpt-5.6-sol
+     * in /v1/chat/completions") whenever `tools` is present on a Chat
+     * Completions request. The lumic OpenAI provider reads this flag to
+     * transparently route tool-bearing calls for such models to the Responses
+     * API while keeping the returned {@link LLMResponse} envelope byte-identical.
+     *
+     * Omitted (⇒ `false`) for every model that accepts function tools on Chat
+     * Completions — INCLUDING the o-series reasoning models (o1/o3/o4-mini),
+     * which accept `tools` on `/v1/chat/completions` today and therefore stay on
+     * the Chat path. Only set this when a model 400s on Chat Completions + tools.
+     *
+     * Deliberately data-driven: the call path branches on this flag, never on
+     * hardcoded model-name string checks.
+     */
+    requiresResponsesApiForTools?: boolean;
 }
 /**
  * Configuration for OpenAI-compatible providers (Deepseek, Kimi, Qwen, xAI, Gemini, etc.)
@@ -41,7 +61,8 @@ export declare const SUPPORTED_MODELS: {
         readonly supportsStructuredOutput: true;
         readonly supportsDeveloperPrompt: true;
         readonly supportsTemperature: false;
-        readonly isReasoningModel: false;
+        readonly isReasoningModel: true;
+        readonly requiresResponsesApiForTools: true;
     };
     readonly 'gpt-5.6-terra': {
         readonly provider: "openai";
@@ -50,7 +71,8 @@ export declare const SUPPORTED_MODELS: {
         readonly supportsStructuredOutput: true;
         readonly supportsDeveloperPrompt: true;
         readonly supportsTemperature: false;
-        readonly isReasoningModel: false;
+        readonly isReasoningModel: true;
+        readonly requiresResponsesApiForTools: true;
     };
     readonly 'gpt-5.6-luna': {
         readonly provider: "openai";
@@ -59,7 +81,8 @@ export declare const SUPPORTED_MODELS: {
         readonly supportsStructuredOutput: true;
         readonly supportsDeveloperPrompt: true;
         readonly supportsTemperature: false;
-        readonly isReasoningModel: false;
+        readonly isReasoningModel: true;
+        readonly requiresResponsesApiForTools: true;
     };
     readonly 'gpt-5.5': {
         readonly provider: "openai";
@@ -549,7 +572,15 @@ export interface LLMOptions {
     developerPrompt?: string;
     context?: ChatCompletionMessageParam[];
     store?: boolean;
-    reasoning_effort?: 'low' | 'medium' | 'high';
+    /**
+     * Reasoning effort for reasoning models, on OpenAI's 2026 ladder ordered from
+     * least to most effort: `none` < `minimal` < `low` < `medium` < `high` <
+     * `xhigh`. (There is no `max` level.) Callers may request any level; the
+     * OpenAI provider clamps it per-model to a level the target model — and the
+     * installed OpenAI SDK — actually accepts, so an over- or under-shoot degrades
+     * gracefully instead of returning HTTP 400. Ignored for non-reasoning models.
+     */
+    reasoning_effort?: 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh';
     metadata?: Record<string, string>;
     parallel_tool_calls?: boolean;
     service_tier?: 'auto' | 'default';
@@ -604,12 +635,18 @@ export type OpenAIResponseFormat = 'text' | 'json' | {
     };
 };
 /**
- * Default model tiers per provider for use with LLM_MODEL_MINI/NORMAL/ADVANCED env vars
+ * Default model tiers per provider for use with the
+ * LLM_MODEL_MINI/NORMAL/ADVANCED/CRITICAL env vars.
+ *
+ * Four tiers, increasing in capability/cost: `mini` (high-volume, cheap) →
+ * `normal` (default) → `advanced` → `critical` (most-capable). The tier a caller
+ * lands on is resolved in `../utils/config` (see `LLM_MODEL_*`).
  */
 export declare const PROVIDER_DEFAULT_MODELS: Record<LLMProvider, {
     mini: SupportedModel;
     normal: SupportedModel;
     advanced: SupportedModel;
+    critical: SupportedModel;
 }>;
 /**
  * Represents the options for the OpenAI Images API.

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

@@ -10,6 +10,7 @@ export declare const LLM_DEFAULT_PROVIDER: LLMProvider;
 export declare const LLM_MINI_PROVIDER: LLMProvider;
 export declare const LLM_NORMAL_PROVIDER: LLMProvider;
 export declare const LLM_ADVANCED_PROVIDER: LLMProvider;
+export declare const LLM_CRITICAL_PROVIDER: LLMProvider;
 export declare const LLM_PROVIDER: LLMProvider;
 /**
  * The default model to use when no model is specified.
@@ -20,17 +21,25 @@ export declare const DEFAULT_MODEL: LLMModel;
  * Model tier values resolved from env vars.
  *
  * Resolution order per tier:
- *   1. LLM_MODEL_MINI / LLM_MODEL_NORMAL / LLM_MODEL_ADVANCED (explicit model override)
+ *   1. LLM_MODEL_MINI / LLM_MODEL_NORMAL / LLM_MODEL_ADVANCED / LLM_MODEL_CRITICAL (explicit model override)
  *   2. PROVIDER_DEFAULT_MODELS[tier-specific provider][tier] (provider default for tier)
  *
  * The tier-specific provider is:
  *   LLM_MINI_PROVIDER → falls back to LLM_DEFAULT_PROVIDER
  *   LLM_NORMAL_PROVIDER → falls back to LLM_DEFAULT_PROVIDER
  *   LLM_ADVANCED_PROVIDER → falls back to LLM_DEFAULT_PROVIDER
+ *   LLM_CRITICAL_PROVIDER → falls back to LLM_DEFAULT_PROVIDER
  */
 export declare const LLM_MODEL_MINI: LLMModel;
 export declare const LLM_MODEL_NORMAL: LLMModel;
 export declare const LLM_MODEL_ADVANCED: LLMModel;
+/**
+ * The most-capable ("critical") model tier — reserved for the highest-stakes
+ * calls. Resolves from LLM_MODEL_CRITICAL, else the critical-tier default of the
+ * resolved LLM_CRITICAL_PROVIDER (see PROVIDER_DEFAULT_MODELS). For OpenAI this
+ * is gpt-5.6-sol; for other providers it mirrors their advanced tier.
+ */
+export declare const LLM_MODEL_CRITICAL: LLMModel;
 export declare const PERPLEXITY_MODEL: string;
 export declare const PERPLEXITY_API_URL = "https://api.perplexity.ai/chat/completions";
 export interface Config {
@@ -39,9 +48,11 @@ export interface Config {
     LLM_MINI_PROVIDER: LLMProvider;
     LLM_NORMAL_PROVIDER: LLMProvider;
     LLM_ADVANCED_PROVIDER: LLMProvider;
+    LLM_CRITICAL_PROVIDER: LLMProvider;
     LLM_MODEL_MINI: string;
     LLM_MODEL_NORMAL: string;
     LLM_MODEL_ADVANCED: string;
+    LLM_MODEL_CRITICAL: string;
     PERPLEXITY_MODEL: string;
     PERPLEXITY_API_URL: string;
 }

package/dist/types/utils/llm-cost-tracker.d.ts

@@ -107,8 +107,8 @@ export declare class LLMCostTracker {
      * @param provider - The LLM provider ('openai' or 'deepseek')
      * @param model - The model name (e.g., 'gpt-5', 'deepseek-chat')
      * @param inputTokens - Number of input/prompt tokens
-     * @param outputTokens - Number of output/completion tokens
-     * @param reasoningTokens - Number of reasoning tokens (default: 0)
+     * @param outputTokens - Total output/completion tokens, INCLUDING reasoning tokens
+     * @param reasoningTokens - Reasoning tokens, a subset of outputTokens (default: 0). Billed at the output rate, not on top of it.
      * @param cacheHitTokens - Number of cache hit tokens (default: 0)
      */
     trackUsage(provider: string, model: string, inputTokens: number, outputTokens: number, reasoningTokens?: number, cacheHitTokens?: number): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adaptic/lumic-utils",
-  "version": "1.0.28",
+  "version": "1.0.29",
   "description": "NPM repo set of utility functions usable across the entire organisation.",
   "always-build-npm": false,
   "type": "module",