@adaptic/lumic-utils 1.0.19 → 1.0.21

package/dist/index.cjs

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

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-CSQmloZ-.js';
+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-DYehXKUX.js';
 import 'openai';
 import 'zod';
 import '@aws-sdk/client-s3';

package/dist/test.cjs

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

package/dist/test.mjs

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

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

@@ -6,7 +6,15 @@ interface AIModelCosts {
         cacheHitCost?: number;
     };
 }
-/** Token costs in USD per token. Last updated Mar 2026. */
+/**
+ * Token costs in USD per token. Last updated Apr 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).
+ */
 export declare const openAiModelCosts: AIModelCosts;
 export declare const anthropicModelCosts: AIModelCosts;
 export declare const deepseekModelCosts: AIModelCosts;

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

@@ -392,6 +392,13 @@ export declare function getModelCapabilities(model: SupportedModel): Readonly<Mo
 export declare function getModelProvider(model: SupportedModel): LLMProvider;
 /**
  * Represents the usage of the LLM.
+ *
+ * `cached_tokens` is the canonical OpenAI naming for input tokens served from
+ * the prompt cache. It is populated from `usage.prompt_tokens_details.cached_tokens`
+ * (Chat Completions API) or `usage.input_tokens_details.cached_tokens`
+ * (Responses API). DeepSeek emits both `prompt_cache_hit_tokens` and the
+ * OpenAI-compatible `prompt_tokens_details.cached_tokens`; we always read the
+ * OpenAI-compatible field so a single canonical name covers all providers.
  */
 export interface LLMUsage {
     prompt_tokens: number;
@@ -399,7 +406,7 @@ export interface LLMUsage {
     reasoning_tokens?: number;
     provider: string;
     model: LLMModel;
-    cache_hit_tokens?: number;
+    cached_tokens?: number;
     cost: number;
 }
 /**

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

@@ -49,6 +49,7 @@ export interface CostSummary {
     totalCost: number;
     totalCalls: number;
     totalInputTokens: number;
+    totalCacheHitTokens: number;
     totalOutputTokens: number;
     totalReasoningTokens: number;
     byModel: Record<string, ModelCostSummary>;
@@ -70,7 +71,9 @@ export interface FormattedCostSummary {
         cost: string;
         calls: number;
         inputTokens: number;
+        cachedTokens: number;
         outputTokens: number;
+        reasoningTokens: number;
     }>;
     images: Array<{
         model: string;

package/package.json

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