@adaptic/lumic-utils 1.0.8 → 1.0.10

package/dist/types/functions/zip-utils.d.ts

@@ -1,7 +1,7 @@
 /**
  * Creates a zip file containing the contents of the provided directory.
- * The zip file is created in the configured temp directory (default: os.tmpdir()).
- * The source directory must be within an allowed path (configurable via LUMIC_ALLOWED_UPLOAD_PATHS).
+ * The zip file is created in the /tmp directory.
+ * The source directory must be located in the /tmp directory.
  * The zip file name is the same as the source directory name with a .zip extension.
  * If a node_modules directory exists in the source directory,
  * it is added separately to ensure it is included in the zip file.
@@ -14,27 +14,25 @@ export declare function createZipFile(sourceDir: string): Promise<string>;
 /**
  * Extracts a zip archive into a specified directory.
  *
- * Both the zip file path and destination path must be within an allowed path
- * (configurable via LUMIC_ALLOWED_UPLOAD_PATHS, defaults to os.tmpdir()).
+ * Both the zip file path and destination path must start with /tmp/.
  *
- * @param zipPath The path of the zip file to extract.
- * @param destPath The path of the directory to extract the zip file into.
+ * @param zipPath The path of the zip file to extract. Must start with /tmp/.
+ * @param destPath The path of the directory to extract the zip file into. Must start with /tmp/.
  * @returns The path of the extracted directory.
- * @throws If the paths are not within allowed paths.
+ * @throws If the zip file or destination path does not start with /tmp/.
  * @throws If there is an error extracting the zip file.
  */
 export declare function extractZipFile(zipPath: string, destPath: string): Promise<string>;
 /**
  * Adds a file or directory to an existing zip file.
  *
- * The zip file path and item path must be within an allowed path
- * (configurable via LUMIC_ALLOWED_UPLOAD_PATHS, defaults to os.tmpdir()).
+ * The zip file path and item path must start with /tmp/.
  *
- * @param zipFilePath The path of the zip file to add the item to.
- * @param itemPath The path of the item to add to the zip file.
+ * @param zipFilePath The path of the zip file to add the item to. Must start with /tmp/.
+ * @param itemPath The path of the item to add to the zip file. Must start with /tmp/.
  * @param destPath Optional. The destination path inside the zip file to add the item to. Defaults to the root of the zip file.
  * @returns The path of the updated zip file.
- * @throws If the paths are not within allowed paths.
+ * @throws If the zip file or item path does not start with /tmp/.
  * @throws If there is an error adding the item to the zip file.
  */
 export declare function addToZipFile(zipFilePath: string, itemPath: string, destPath?: string): Promise<string>;

package/dist/types/google-types.ts

@@ -13,19 +13,16 @@ export interface GoogleSheetRange {
   endCell: GoogleSheetCell;
 }
 
-/** Represents a primitive value that can be stored in a Google Sheet cell */
-export type GoogleSheetCellValue = string | number | boolean | null;
-
 export interface GoogleSheetResponse {
   success: boolean;
   error?: string;
-  data?: unknown;
+  data?: any;
 }
 
 export interface GoogleSheetAddRowResponse extends GoogleSheetResponse {
   data?: {
     rowNumber: number;
-    values: GoogleSheetCellValue[];
+    values: any[];
   };
 }
 
@@ -38,7 +35,7 @@ export interface GoogleSheetAddSheetResponse extends GoogleSheetResponse {
 
 export interface GoogleSheetCellResponse extends GoogleSheetResponse {
   data?: {
-    value: GoogleSheetCellValue;
+    value: any;
   };
 }
 

package/dist/types/index.d.ts

@@ -14,37 +14,7 @@ import { createPDFFromMarkdown } from './functions/pdf-create';
 import { addRow, addSheet, writeCell, getCell, writeArray } from './functions/google-sheets';
 import { parseResponse } from './functions/llm-utils';
 import { tools } from './llm-tools';
-import { LumicLogger, setLumicLogger, getLumicLogger } from './utils/logger';
-import { sanitizeForLog, sanitizeError, sanitizeAWSAuth, sanitizeObject } from './utils/sanitizer';
 export * from './types';
-export * from './errors';
-export * from './utils/timeouts';
-export { LumicLogger, setLumicLogger, getLumicLogger };
-export { sanitizeForLog, sanitizeError, sanitizeAWSAuth, sanitizeObject };
-export { getSecrets, resetSecrets, requireSecret } from './config/secrets';
-export type { LumicSecrets } from './config/secrets';
-export { withRetry } from './utils/retry';
-export type { RetryConfig } from './utils/retry';
-export { CircuitBreaker, CircuitBreakerState, CircuitBreakerOpenError, DEFAULT_CIRCUIT_BREAKER_CONFIG, } from './utils/circuit-breaker';
-export type { CircuitBreakerConfig, CircuitBreakerStateChangeCallback, } from './utils/circuit-breaker';
-export { validateSlackChannel, validateS3Key, validateGoogleSheetsRange, } from './utils/input-validator';
-export type { ValidationResult } from './utils/input-validator';
-export { LLMCostTracker, getLLMCostTracker, setLLMCostTracker, resetLLMCostTracker, } from './utils/llm-cost-tracker';
-export type { LLMUsageRecord, ImageUsageRecord, ModelCostSummary, ImageCostSummary, CostSummary, FormattedCostSummary, } from './utils/llm-cost-tracker';
-export { setMetricsCollector, getMetricsCollector, resetMetricsCollector, withMetrics, } from './utils/metrics';
-export type { MetricsCollector } from './utils/metrics';
-export { generateCorrelationId, getCorrelationId, getCorrelationContext, withCorrelationId, getCorrelationHeaders, } from './utils/correlation';
-export type { CorrelationContext } from './utils/correlation';
-export { TokenBucketRateLimiter, RATE_LIMIT_PROFILES, getRateLimiter, resetAllRateLimiters, withRateLimit, } from './utils/rate-limiter';
-export type { RateLimiterConfig } from './utils/rate-limiter';
-export { checkIntegrationHealth } from './utils/health-check';
-export type { IntegrationHealthStatus, HealthCheckResult, } from './utils/health-check';
-export { ParseJsonOptions } from './functions/llm-utils';
-export { FixJsonWithAIOptions } from './functions/json-llm-tools';
-export { SUPPORTED_MODELS, isValidModel, getModelCapabilities } from './types/openai-types';
-export type { SupportedModel, OpenAIModel, DeepseekModel, LLMModel } from './types/openai-types';
-export { openAIChatCompletionSchema, openAIImageResponseSchema, validateOpenAIChatCompletion, safeValidateOpenAIChatCompletion, perplexityResponseSchema, validatePerplexityResponse, safeValidatePerplexityResponse, googleSheetsValueRangeSchema, validateGoogleSheetsResponse, safeValidateGoogleSheetsResponse, s3ListObjectsSchema, s3GetObjectSchema, lambdaInvokeResponseSchema, validateS3ListObjects, safeValidateS3ListObjects, validateLambdaResponse, safeValidateLambdaResponse, createValidator, createSafeValidator, } from './schemas';
-export type { ValidationResult as SchemaValidationResult } from './schemas';
 interface LumicUtilities {
     llm: {
         call: typeof makeLLMCall;

package/dist/types/index.ts

@@ -27,7 +27,7 @@ export type InvocationType = 'RequestResponse' | 'Event' | 'DryRun';
 
 export interface LambdaResponse {
   statusCode: number;
-  [key: string]: unknown;
+  [key: string]: any;
 }
 
 // Export types from sendMessageToSlack

package/dist/types/openai-types.ts

@@ -1,176 +1,22 @@
 // openai-types.ts
 import { ChatCompletionMessageParam, ChatCompletionTool, ChatCompletionMessageToolCall } from 'openai/resources/chat/completions';
-import { ImageGenerateParams } from 'openai/resources/images';
-
-/**
- * Model capability configuration
- */
-interface ModelCapabilities {
-  provider: 'openai' | 'deepseek';
-  supportsTools: boolean;
-  supportsJson: boolean;
-  supportsStructuredOutput: boolean;
-  supportsDeveloperPrompt: boolean;
-  supportsTemperature: boolean;
-  isReasoningModel: boolean;
-}
-
-/**
- * Supported models with their capabilities
- */
-export const SUPPORTED_MODELS = {
-  // OpenAI GPT-5 series
-  'gpt-5': {
-    provider: 'openai',
-    supportsTools: true,
-    supportsJson: true,
-    supportsStructuredOutput: true,
-    supportsDeveloperPrompt: true,
-    supportsTemperature: true,
-    isReasoningModel: false,
-  },
-  'gpt-5-mini': {
-    provider: 'openai',
-    supportsTools: true,
-    supportsJson: true,
-    supportsStructuredOutput: true,
-    supportsDeveloperPrompt: true,
-    supportsTemperature: true,
-    isReasoningModel: false,
-  },
-  // OpenAI GPT-4.1 series
-  'gpt-4.1': {
-    provider: 'openai',
-    supportsTools: true,
-    supportsJson: true,
-    supportsStructuredOutput: true,
-    supportsDeveloperPrompt: true,
-    supportsTemperature: true,
-    isReasoningModel: false,
-  },
-  'gpt-4.1-mini': {
-    provider: 'openai',
-    supportsTools: true,
-    supportsJson: true,
-    supportsStructuredOutput: true,
-    supportsDeveloperPrompt: true,
-    supportsTemperature: true,
-    isReasoningModel: false,
-  },
-  'gpt-4.1-nano': {
-    provider: 'openai',
-    supportsTools: true,
-    supportsJson: true,
-    supportsStructuredOutput: true,
-    supportsDeveloperPrompt: true,
-    supportsTemperature: true,
-    isReasoningModel: false,
-  },
-  // OpenAI reasoning models (o-series)
-  'o1': {
-    provider: 'openai',
-    supportsTools: true,
-    supportsJson: false,
-    supportsStructuredOutput: true,
-    supportsDeveloperPrompt: true,
-    supportsTemperature: false,
-    isReasoningModel: true,
-  },
-  'o1-mini': {
-    provider: 'openai',
-    supportsTools: true,
-    supportsJson: false,
-    supportsStructuredOutput: false,
-    supportsDeveloperPrompt: false,
-    supportsTemperature: false,
-    isReasoningModel: true,
-  },
-  'o3': {
-    provider: 'openai',
-    supportsTools: true,
-    supportsJson: false,
-    supportsStructuredOutput: true,
-    supportsDeveloperPrompt: true,
-    supportsTemperature: false,
-    isReasoningModel: true,
-  },
-  'o3-mini': {
-    provider: 'openai',
-    supportsTools: true,
-    supportsJson: true,
-    supportsStructuredOutput: true,
-    supportsDeveloperPrompt: true,
-    supportsTemperature: false,
-    isReasoningModel: true,
-  },
-  'o4-mini': {
-    provider: 'openai',
-    supportsTools: true,
-    supportsJson: false,
-    supportsStructuredOutput: true,
-    supportsDeveloperPrompt: true,
-    supportsTemperature: false,
-    isReasoningModel: true,
-  },
-  // Deepseek models
-  'deepseek-chat': {
-    provider: 'deepseek',
-    supportsTools: true,
-    supportsJson: true,
-    supportsStructuredOutput: false,
-    supportsDeveloperPrompt: true,
-    supportsTemperature: true,
-    isReasoningModel: false,
-  },
-  'deepseek-reasoner': {
-    provider: 'deepseek',
-    supportsTools: false,
-    supportsJson: false,
-    supportsStructuredOutput: false,
-    supportsDeveloperPrompt: true,
-    supportsTemperature: true,
-    isReasoningModel: true,
-  },
-} as const satisfies Record<string, ModelCapabilities>;
-
-/**
- * Represents all supported LLM models
- */
-export type SupportedModel = keyof typeof SUPPORTED_MODELS;
+import { ImageGenerateParams, ImageModel } from 'openai/resources/images';
 
 /**
  * Represents OpenAI models
  */
-export type OpenAIModel = Extract<SupportedModel, 'gpt-5' | 'gpt-5-mini' | 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'o1' | 'o1-mini' | 'o3' | 'o3-mini' | 'o4-mini'>;
 
+export type OpenAIModel = 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano'
 /**
  * Represents Deepseek models
  */
-export type DeepseekModel = Extract<SupportedModel, 'deepseek-chat' | 'deepseek-reasoner'>;
+export type DeepseekModel = 'deepseek-chat' | 'deepseek-reasoner';
 
 /**
  * Represents all supported LLM models
  */
 export type LLMModel = OpenAIModel | DeepseekModel;
 
-/**
- * Type guard to check if a string is a valid supported model
- * @param model The model name to validate
- * @returns True if the model is supported
- */
-export function isValidModel(model: string): model is SupportedModel {
-  return model in SUPPORTED_MODELS;
-}
-
-/**
- * Get capabilities for a supported model
- * @param model The model to get capabilities for
- * @returns Model capabilities object
- */
-export function getModelCapabilities(model: SupportedModel): Readonly<ModelCapabilities> {
-  return SUPPORTED_MODELS[model];
-}
-
 /**
  * Represents the usage of the LLM.
  */
@@ -203,11 +49,6 @@ export interface LLMOptions {
   parallel_tool_calls?: boolean;
   service_tier?: 'auto' | 'default';
   apiKey?: string;
-  /**
-   * Request timeout in milliseconds. Overrides the default LLM_TIMEOUT_MS (120000ms).
-   * Applied to the OpenAI/Deepseek SDK client for the request.
-   */
-  timeout?: number;
 }
 
 /**
@@ -222,11 +63,11 @@ export interface LLMResponse<T> {
 /**
  * Represents the format of the OpenAI response.
  */
-export type OpenAIResponseFormat = 'text' | 'json' | {
-  type: 'json_schema';
+export type OpenAIResponseFormat = 'text' | 'json' | { 
+  type: 'json_schema'; 
   schema: {
     type: 'object';
-    properties: Record<string, unknown>;
+    properties: Record<string, any>;
     required?: string[];
   }
 };

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

@@ -29,7 +29,7 @@ export interface SaveToS3Response {
 }
 export interface LoadFromS3Response {
     success: boolean;
-    content?: unknown;
+    content?: any;
     error?: string;
 }
 export interface CheckBucketResponse {

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

@@ -10,17 +10,15 @@ export interface GoogleSheetRange {
     startCell: GoogleSheetCell;
     endCell: GoogleSheetCell;
 }
-/** Represents a primitive value that can be stored in a Google Sheet cell */
-export type GoogleSheetCellValue = string | number | boolean | null;
 export interface GoogleSheetResponse {
     success: boolean;
     error?: string;
-    data?: unknown;
+    data?: any;
 }
 export interface GoogleSheetAddRowResponse extends GoogleSheetResponse {
     data?: {
         rowNumber: number;
-        values: GoogleSheetCellValue[];
+        values: any[];
     };
 }
 export interface GoogleSheetAddSheetResponse extends GoogleSheetResponse {
@@ -31,7 +29,7 @@ export interface GoogleSheetAddSheetResponse extends GoogleSheetResponse {
 }
 export interface GoogleSheetCellResponse extends GoogleSheetResponse {
     data?: {
-        value: GoogleSheetCellValue;
+        value: any;
     };
 }
 export interface GoogleSheetWriteArrayResponse extends GoogleSheetResponse {

package/dist/types/types/index.d.ts

@@ -20,7 +20,7 @@ export interface PerplexityResponse {
 export type InvocationType = 'RequestResponse' | 'Event' | 'DryRun';
 export interface LambdaResponse {
     statusCode: number;
-    [key: string]: unknown;
+    [key: string]: any;
 }
 export interface SlackApiResponse {
     ok: boolean;

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

@@ -1,158 +1,17 @@
 import { ChatCompletionMessageParam, ChatCompletionTool, ChatCompletionMessageToolCall } from 'openai/resources/chat/completions';
 import { ImageGenerateParams } from 'openai/resources/images';
-/**
- * Model capability configuration
- */
-interface ModelCapabilities {
-    provider: 'openai' | 'deepseek';
-    supportsTools: boolean;
-    supportsJson: boolean;
-    supportsStructuredOutput: boolean;
-    supportsDeveloperPrompt: boolean;
-    supportsTemperature: boolean;
-    isReasoningModel: boolean;
-}
-/**
- * Supported models with their capabilities
- */
-export declare const SUPPORTED_MODELS: {
-    readonly 'gpt-5': {
-        readonly provider: "openai";
-        readonly supportsTools: true;
-        readonly supportsJson: true;
-        readonly supportsStructuredOutput: true;
-        readonly supportsDeveloperPrompt: true;
-        readonly supportsTemperature: true;
-        readonly isReasoningModel: false;
-    };
-    readonly 'gpt-5-mini': {
-        readonly provider: "openai";
-        readonly supportsTools: true;
-        readonly supportsJson: true;
-        readonly supportsStructuredOutput: true;
-        readonly supportsDeveloperPrompt: true;
-        readonly supportsTemperature: true;
-        readonly isReasoningModel: false;
-    };
-    readonly 'gpt-4.1': {
-        readonly provider: "openai";
-        readonly supportsTools: true;
-        readonly supportsJson: true;
-        readonly supportsStructuredOutput: true;
-        readonly supportsDeveloperPrompt: true;
-        readonly supportsTemperature: true;
-        readonly isReasoningModel: false;
-    };
-    readonly 'gpt-4.1-mini': {
-        readonly provider: "openai";
-        readonly supportsTools: true;
-        readonly supportsJson: true;
-        readonly supportsStructuredOutput: true;
-        readonly supportsDeveloperPrompt: true;
-        readonly supportsTemperature: true;
-        readonly isReasoningModel: false;
-    };
-    readonly 'gpt-4.1-nano': {
-        readonly provider: "openai";
-        readonly supportsTools: true;
-        readonly supportsJson: true;
-        readonly supportsStructuredOutput: true;
-        readonly supportsDeveloperPrompt: true;
-        readonly supportsTemperature: true;
-        readonly isReasoningModel: false;
-    };
-    readonly o1: {
-        readonly provider: "openai";
-        readonly supportsTools: true;
-        readonly supportsJson: false;
-        readonly supportsStructuredOutput: true;
-        readonly supportsDeveloperPrompt: true;
-        readonly supportsTemperature: false;
-        readonly isReasoningModel: true;
-    };
-    readonly 'o1-mini': {
-        readonly provider: "openai";
-        readonly supportsTools: true;
-        readonly supportsJson: false;
-        readonly supportsStructuredOutput: false;
-        readonly supportsDeveloperPrompt: false;
-        readonly supportsTemperature: false;
-        readonly isReasoningModel: true;
-    };
-    readonly o3: {
-        readonly provider: "openai";
-        readonly supportsTools: true;
-        readonly supportsJson: false;
-        readonly supportsStructuredOutput: true;
-        readonly supportsDeveloperPrompt: true;
-        readonly supportsTemperature: false;
-        readonly isReasoningModel: true;
-    };
-    readonly 'o3-mini': {
-        readonly provider: "openai";
-        readonly supportsTools: true;
-        readonly supportsJson: true;
-        readonly supportsStructuredOutput: true;
-        readonly supportsDeveloperPrompt: true;
-        readonly supportsTemperature: false;
-        readonly isReasoningModel: true;
-    };
-    readonly 'o4-mini': {
-        readonly provider: "openai";
-        readonly supportsTools: true;
-        readonly supportsJson: false;
-        readonly supportsStructuredOutput: true;
-        readonly supportsDeveloperPrompt: true;
-        readonly supportsTemperature: false;
-        readonly isReasoningModel: true;
-    };
-    readonly 'deepseek-chat': {
-        readonly provider: "deepseek";
-        readonly supportsTools: true;
-        readonly supportsJson: true;
-        readonly supportsStructuredOutput: false;
-        readonly supportsDeveloperPrompt: true;
-        readonly supportsTemperature: true;
-        readonly isReasoningModel: false;
-    };
-    readonly 'deepseek-reasoner': {
-        readonly provider: "deepseek";
-        readonly supportsTools: false;
-        readonly supportsJson: false;
-        readonly supportsStructuredOutput: false;
-        readonly supportsDeveloperPrompt: true;
-        readonly supportsTemperature: true;
-        readonly isReasoningModel: true;
-    };
-};
-/**
- * Represents all supported LLM models
- */
-export type SupportedModel = keyof typeof SUPPORTED_MODELS;
 /**
  * Represents OpenAI models
  */
-export type OpenAIModel = Extract<SupportedModel, 'gpt-5' | 'gpt-5-mini' | 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'o1' | 'o1-mini' | 'o3' | 'o3-mini' | 'o4-mini'>;
+export type OpenAIModel = 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano';
 /**
  * Represents Deepseek models
  */
-export type DeepseekModel = Extract<SupportedModel, 'deepseek-chat' | 'deepseek-reasoner'>;
+export type DeepseekModel = 'deepseek-chat' | 'deepseek-reasoner';
 /**
  * Represents all supported LLM models
  */
 export type LLMModel = OpenAIModel | DeepseekModel;
-/**
- * Type guard to check if a string is a valid supported model
- * @param model The model name to validate
- * @returns True if the model is supported
- */
-export declare function isValidModel(model: string): model is SupportedModel;
-/**
- * Get capabilities for a supported model
- * @param model The model to get capabilities for
- * @returns Model capabilities object
- */
-export declare function getModelCapabilities(model: SupportedModel): Readonly<ModelCapabilities>;
 /**
  * Represents the usage of the LLM.
  */
@@ -184,11 +43,6 @@ export interface LLMOptions {
     parallel_tool_calls?: boolean;
     service_tier?: 'auto' | 'default';
     apiKey?: string;
-    /**
-     * Request timeout in milliseconds. Overrides the default LLM_TIMEOUT_MS (120000ms).
-     * Applied to the OpenAI/Deepseek SDK client for the request.
-     */
-    timeout?: number;
 }
 /**
  * Represents the response from the LLM.
@@ -205,7 +59,7 @@ export type OpenAIResponseFormat = 'text' | 'json' | {
     type: 'json_schema';
     schema: {
         type: 'object';
-        properties: Record<string, unknown>;
+        properties: Record<string, any>;
         required?: string[];
     };
 };

package/dist/types/utils/aws-initialise.d.ts

@@ -18,9 +18,4 @@ interface AWSAuth {
 declare const validateEnvironmentVars: () => ValidationResult;
 declare const initialiseS3Client: (auth?: AWSAuth | null) => S3Client;
 declare const initialiseLambdaClient: (auth?: AWSAuth | null) => Lambda;
-/**
- * Clears all cached AWS client instances.
- * Useful for testing or when credentials need to be refreshed.
- */
-declare const clearClientCache: () => void;
-export { validateEnvironmentVars, initialiseS3Client, initialiseLambdaClient, clearClientCache, AWSAuth };
+export { validateEnvironmentVars, initialiseS3Client, initialiseLambdaClient, AWSAuth };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adaptic/lumic-utils",
-  "version": "1.0.8",
+  "version": "1.0.10",
   "description": "NPM repo set of utility functions usable across the entire organisation.",
   "always-build-npm": false,
   "type": "module",
@@ -22,7 +22,7 @@
     "build": "npm run clean && npm run build:js && npm run build:tools && npm run build:types",
     "build:js": "rollup -c",
     "build:tools": "node --loader ts-node/esm compile-tool-definitions.ts",
-    "build:types": "mkdir -p dist/types && cp -r src/types/* dist/types/",
+    "build:types": "tsc --emitDeclarationOnly --declaration --declarationDir dist/types",
     "test": "vitest run",
     "test:watch": "vitest",
     "test:legacy": "npm run build && node dist/test.mjs",
@@ -37,6 +37,7 @@
   "license": "Ask yo mamma",
   "dependencies": {
     "@adaptic/utils": "^0.1.1",
+    "@anthropic-ai/sdk": "^0.80.0",
     "@aws-sdk/client-lambda": "^3.840.0",
     "@aws-sdk/client-s3": "^3.842.0",
     "@googleapis/sheets": "^10.0.1",