@adaptic/lumic-utils 1.0.23 → 1.0.25

package/dist/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var index = require('./index-WGzi__C5.js');
+var index = require('./index-ChygDqeG.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-CWoI2dXN.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-Bvc61lYS.js';
 import 'openai';
 import 'zod';
 import '@aws-sdk/client-s3';

package/dist/test.cjs

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

package/dist/test.mjs

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

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

@@ -53,4 +53,9 @@ export declare const makeResponsesAPICall: <T = unknown>(input: string | Respons
     apiKey?: string;
     model?: string;
     timeout?: number;
+    /**
+     * Optional AbortSignal for cooperative cancellation. See
+     * {@link LLMOptions.signal} for full semantics.
+     */
+    signal?: AbortSignal;
 }) => Promise<LLMResponse<T>>;

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

@@ -522,6 +522,31 @@ export interface LLMOptions {
      * Request timeout in milliseconds. Overrides the default LLM_TIMEOUT_MS (120000ms).
      */
     timeout?: number;
+    /**
+     * Optional AbortSignal for cooperative cancellation of an in-flight LLM
+     * call. When the signal aborts, the underlying SDK HTTP request is
+     * interrupted, the call rejects, and the response body (which can be
+     * tens of KB and is held in the closure of the resolving promise
+     * chain) is released immediately rather than at the timeout boundary.
+     *
+     * This is the correct primitive for caller-driven cancel-and-restart
+     * patterns (e.g. an upstream session is superseded by a fresher signal
+     * snapshot) where the engine-side timeout race would otherwise leave
+     * an orphaned HTTP request pinning context memory for up to
+     * `timeout` ms.
+     *
+     * Plumbed through:
+     *   - OpenAI provider: openai.chat.completions.create(queryOptions, { signal })
+     *   - Anthropic provider: anthropic.messages.create({ ... }, { signal })
+     *   - OpenAI-compatible providers (Deepseek/Kimi/Qwen/xAI/Gemini):
+     *     same shape as OpenAI provider
+     *
+     * Adding this to a provider's request options does NOT cancel any
+     * retry attempts already in flight inside `withRetry` — the signal is
+     * checked on each attempt boundary, and `withRetry` itself aborts the
+     * loop when the signal fires.
+     */
+    signal?: AbortSignal;
 }
 /**
  * Represents the response from the LLM.

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

@@ -9,6 +9,14 @@ export interface RetryConfig {
     retryableErrors?: (error: unknown) => boolean;
     /** Optional circuit breaker to check before each attempt */
     circuitBreaker?: CircuitBreaker;
+    /**
+     * Optional AbortSignal for cooperative cancellation. When the signal
+     * aborts, in-flight inter-attempt sleep is interrupted and the next
+     * attempt is skipped (the underlying `fn` is also expected to honour
+     * the signal — that wiring is provider-specific and happens in the
+     * caller, not here).
+     */
+    signal?: AbortSignal;
 }
 /**
  * Default retry configuration

package/package.json

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