@adaptic/lumic-utils 1.0.12 → 1.0.13

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

@@ -1,17 +1,395 @@
 import { ChatCompletionMessageParam, ChatCompletionTool, ChatCompletionMessageToolCall } from 'openai/resources/chat/completions';
 import { ImageGenerateParams } from 'openai/resources/images';
+/**
+ * All supported LLM provider identifiers
+ */
+export type LLMProvider = 'openai' | 'anthropic' | 'deepseek' | 'kimi' | 'qwen' | 'xai' | 'gemini';
+/**
+ * Model capability configuration
+ */
+export interface ModelCapabilities {
+    provider: LLMProvider;
+    supportsTools: boolean;
+    supportsJson: boolean;
+    supportsStructuredOutput: boolean;
+    supportsDeveloperPrompt: boolean;
+    supportsTemperature: boolean;
+    isReasoningModel: boolean;
+}
+/**
+ * Configuration for OpenAI-compatible providers (Deepseek, Kimi, Qwen, xAI, Gemini, etc.)
+ */
+export interface OpenAICompatibleProviderConfig {
+    name: LLMProvider;
+    baseURL: string;
+    apiKeySecretPath: string;
+    apiKeyEnvVar: string;
+}
+/**
+ * Registry of OpenAI-compatible provider configurations.
+ * These providers use the OpenAI SDK with a custom baseURL.
+ */
+export declare const OPENAI_COMPATIBLE_PROVIDERS: Record<string, OpenAICompatibleProviderConfig>;
+/**
+ * Supported models with their capabilities
+ */
+export declare const SUPPORTED_MODELS: {
+    readonly 'gpt-5.4': {
+        readonly provider: "openai";
+        readonly supportsTools: true;
+        readonly supportsJson: true;
+        readonly supportsStructuredOutput: true;
+        readonly supportsDeveloperPrompt: true;
+        readonly supportsTemperature: true;
+        readonly isReasoningModel: false;
+    };
+    readonly 'gpt-5.4-mini': {
+        readonly provider: "openai";
+        readonly supportsTools: true;
+        readonly supportsJson: true;
+        readonly supportsStructuredOutput: true;
+        readonly supportsDeveloperPrompt: true;
+        readonly supportsTemperature: true;
+        readonly isReasoningModel: false;
+    };
+    readonly 'gpt-5.4-nano': {
+        readonly provider: "openai";
+        readonly supportsTools: true;
+        readonly supportsJson: true;
+        readonly supportsStructuredOutput: true;
+        readonly supportsDeveloperPrompt: true;
+        readonly supportsTemperature: true;
+        readonly isReasoningModel: false;
+    };
+    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 'claude-opus-4-6': {
+        readonly provider: "anthropic";
+        readonly supportsTools: true;
+        readonly supportsJson: false;
+        readonly supportsStructuredOutput: false;
+        readonly supportsDeveloperPrompt: true;
+        readonly supportsTemperature: true;
+        readonly isReasoningModel: false;
+    };
+    readonly 'claude-sonnet-4-6': {
+        readonly provider: "anthropic";
+        readonly supportsTools: true;
+        readonly supportsJson: false;
+        readonly supportsStructuredOutput: false;
+        readonly supportsDeveloperPrompt: true;
+        readonly supportsTemperature: true;
+        readonly isReasoningModel: false;
+    };
+    readonly 'claude-haiku-4-5': {
+        readonly provider: "anthropic";
+        readonly supportsTools: true;
+        readonly supportsJson: false;
+        readonly supportsStructuredOutput: false;
+        readonly supportsDeveloperPrompt: true;
+        readonly supportsTemperature: true;
+        readonly isReasoningModel: false;
+    };
+    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;
+    };
+    readonly 'kimi-k2-0905-preview': {
+        readonly provider: "kimi";
+        readonly supportsTools: true;
+        readonly supportsJson: true;
+        readonly supportsStructuredOutput: false;
+        readonly supportsDeveloperPrompt: true;
+        readonly supportsTemperature: true;
+        readonly isReasoningModel: false;
+    };
+    readonly 'kimi-k2-turbo-preview': {
+        readonly provider: "kimi";
+        readonly supportsTools: true;
+        readonly supportsJson: true;
+        readonly supportsStructuredOutput: false;
+        readonly supportsDeveloperPrompt: true;
+        readonly supportsTemperature: true;
+        readonly isReasoningModel: false;
+    };
+    readonly 'kimi-k2-thinking': {
+        readonly provider: "kimi";
+        readonly supportsTools: true;
+        readonly supportsJson: true;
+        readonly supportsStructuredOutput: false;
+        readonly supportsDeveloperPrompt: true;
+        readonly supportsTemperature: true;
+        readonly isReasoningModel: true;
+    };
+    readonly 'kimi-k2-thinking-turbo': {
+        readonly provider: "kimi";
+        readonly supportsTools: true;
+        readonly supportsJson: true;
+        readonly supportsStructuredOutput: false;
+        readonly supportsDeveloperPrompt: true;
+        readonly supportsTemperature: true;
+        readonly isReasoningModel: true;
+    };
+    readonly 'qwen3.5-plus': {
+        readonly provider: "qwen";
+        readonly supportsTools: true;
+        readonly supportsJson: true;
+        readonly supportsStructuredOutput: false;
+        readonly supportsDeveloperPrompt: true;
+        readonly supportsTemperature: true;
+        readonly isReasoningModel: false;
+    };
+    readonly 'qwen3.5-flash': {
+        readonly provider: "qwen";
+        readonly supportsTools: true;
+        readonly supportsJson: true;
+        readonly supportsStructuredOutput: false;
+        readonly supportsDeveloperPrompt: true;
+        readonly supportsTemperature: true;
+        readonly isReasoningModel: false;
+    };
+    readonly 'qwen3-max': {
+        readonly provider: "qwen";
+        readonly supportsTools: true;
+        readonly supportsJson: true;
+        readonly supportsStructuredOutput: false;
+        readonly supportsDeveloperPrompt: true;
+        readonly supportsTemperature: true;
+        readonly isReasoningModel: false;
+    };
+    readonly 'grok-4': {
+        readonly provider: "xai";
+        readonly supportsTools: true;
+        readonly supportsJson: true;
+        readonly supportsStructuredOutput: true;
+        readonly supportsDeveloperPrompt: true;
+        readonly supportsTemperature: true;
+        readonly isReasoningModel: false;
+    };
+    readonly 'grok-4-fast-reasoning': {
+        readonly provider: "xai";
+        readonly supportsTools: true;
+        readonly supportsJson: true;
+        readonly supportsStructuredOutput: true;
+        readonly supportsDeveloperPrompt: true;
+        readonly supportsTemperature: true;
+        readonly isReasoningModel: true;
+    };
+    readonly 'grok-4-fast-non-reasoning': {
+        readonly provider: "xai";
+        readonly supportsTools: true;
+        readonly supportsJson: true;
+        readonly supportsStructuredOutput: true;
+        readonly supportsDeveloperPrompt: true;
+        readonly supportsTemperature: true;
+        readonly isReasoningModel: false;
+    };
+    readonly 'grok-3': {
+        readonly provider: "xai";
+        readonly supportsTools: true;
+        readonly supportsJson: true;
+        readonly supportsStructuredOutput: false;
+        readonly supportsDeveloperPrompt: true;
+        readonly supportsTemperature: true;
+        readonly isReasoningModel: false;
+    };
+    readonly 'grok-3-mini': {
+        readonly provider: "xai";
+        readonly supportsTools: true;
+        readonly supportsJson: true;
+        readonly supportsStructuredOutput: false;
+        readonly supportsDeveloperPrompt: true;
+        readonly supportsTemperature: true;
+        readonly isReasoningModel: false;
+    };
+    readonly 'gemini-3.1-pro-preview': {
+        readonly provider: "gemini";
+        readonly supportsTools: true;
+        readonly supportsJson: true;
+        readonly supportsStructuredOutput: true;
+        readonly supportsDeveloperPrompt: true;
+        readonly supportsTemperature: true;
+        readonly isReasoningModel: false;
+    };
+    readonly 'gemini-3-flash-preview': {
+        readonly provider: "gemini";
+        readonly supportsTools: true;
+        readonly supportsJson: true;
+        readonly supportsStructuredOutput: true;
+        readonly supportsDeveloperPrompt: true;
+        readonly supportsTemperature: true;
+        readonly isReasoningModel: false;
+    };
+    readonly 'gemini-3.1-flash-lite-preview': {
+        readonly provider: "gemini";
+        readonly supportsTools: true;
+        readonly supportsJson: true;
+        readonly supportsStructuredOutput: false;
+        readonly supportsDeveloperPrompt: true;
+        readonly supportsTemperature: true;
+        readonly isReasoningModel: false;
+    };
+};
+/**
+ * Represents all supported LLM models
+ */
+export type SupportedModel = keyof typeof SUPPORTED_MODELS;
 /**
  * Represents OpenAI models
  */
-export type OpenAIModel = 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano';
+export type OpenAIModel = Extract<SupportedModel, 'gpt-5.4' | 'gpt-5.4-mini' | 'gpt-5.4-nano' | 'gpt-5' | 'gpt-5-mini' | 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'o1' | 'o1-mini' | 'o3' | 'o3-mini' | 'o4-mini'>;
+/**
+ * Represents Anthropic Claude models
+ */
+export type AnthropicModel = Extract<SupportedModel, 'claude-opus-4-6' | 'claude-sonnet-4-6' | 'claude-haiku-4-5'>;
 /**
  * Represents Deepseek models
  */
-export type DeepseekModel = 'deepseek-chat' | 'deepseek-reasoner';
+export type DeepseekModel = Extract<SupportedModel, 'deepseek-chat' | 'deepseek-reasoner'>;
+/**
+ * Represents Kimi (Moonshot) models
+ */
+export type KimiModel = Extract<SupportedModel, 'kimi-k2-0905-preview' | 'kimi-k2-turbo-preview' | 'kimi-k2-thinking' | 'kimi-k2-thinking-turbo'>;
+/**
+ * Represents Qwen (Alibaba DashScope) models
+ */
+export type QwenModel = Extract<SupportedModel, 'qwen3.5-plus' | 'qwen3.5-flash' | 'qwen3-max'>;
+/**
+ * Represents xAI Grok models
+ */
+export type XAIModel = Extract<SupportedModel, 'grok-4' | 'grok-4-fast-reasoning' | 'grok-4-fast-non-reasoning' | 'grok-3' | 'grok-3-mini'>;
+/**
+ * Represents Google Gemini models
+ */
+export type GeminiModel = Extract<SupportedModel, 'gemini-3.1-pro-preview' | 'gemini-3-flash-preview' | 'gemini-3.1-flash-lite-preview'>;
 /**
  * Represents all supported LLM models
  */
-export type LLMModel = OpenAIModel | DeepseekModel;
+export type LLMModel = OpenAIModel | AnthropicModel | DeepseekModel | KimiModel | QwenModel | XAIModel | GeminiModel;
+/**
+ * Common model aliases that map to canonical model names
+ */
+export declare const MODEL_ALIASES: Record<string, SupportedModel>;
+/**
+ * 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>;
+/**
+ * Resolve the provider for a given model name
+ * @param model The model name (must be a valid SupportedModel)
+ * @returns The provider identifier
+ */
+export declare function getModelProvider(model: SupportedModel): LLMProvider;
 /**
  * Represents the usage of the LLM.
  */
@@ -28,7 +406,7 @@ export interface LLMUsage {
  * Represents the options for the LLM.
  */
 export interface LLMOptions {
-    model?: OpenAIModel | DeepseekModel;
+    model?: LLMModel;
     temperature?: number;
     top_p?: number;
     frequency_penalty?: number;
@@ -43,6 +421,10 @@ export interface LLMOptions {
     parallel_tool_calls?: boolean;
     service_tier?: 'auto' | 'default';
     apiKey?: string;
+    /**
+     * Request timeout in milliseconds. Overrides the default LLM_TIMEOUT_MS (120000ms).
+     */
+    timeout?: number;
 }
 /**
  * Represents the response from the LLM.
@@ -53,16 +435,24 @@ export interface LLMResponse<T> {
     tool_calls?: ChatCompletionMessageToolCall[];
 }
 /**
- * Represents the format of the OpenAI response.
+ * Represents the format of the LLM response.
  */
 export type OpenAIResponseFormat = 'text' | 'json' | {
     type: 'json_schema';
     schema: {
         type: 'object';
-        properties: Record<string, any>;
+        properties: Record<string, unknown>;
         required?: string[];
     };
 };
+/**
+ * Default model tiers per provider for use with LLM_MODEL_MINI/NORMAL/ADVANCED env vars
+ */
+export declare const PROVIDER_DEFAULT_MODELS: Record<LLMProvider, {
+    mini: SupportedModel;
+    normal: SupportedModel;
+    advanced: SupportedModel;
+}>;
 /**
  * Represents the options for the OpenAI Images API.
  * Extends the official ImageGenerateParams but with more user-friendly option names.

package/dist/types/utils/__tests__/circuit-breaker.test.d.ts

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

package/dist/types/utils/__tests__/correlation.test.d.ts

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

package/dist/types/utils/__tests__/input-validator.test.d.ts

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

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

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

package/dist/types/utils/__tests__/logger.test.d.ts

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

package/dist/types/utils/__tests__/metrics.test.d.ts

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

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

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

package/dist/types/utils/__tests__/sanitizer.test.d.ts

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

package/dist/types/utils/__tests__/timeouts.test.d.ts

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

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

@@ -18,4 +18,9 @@ interface AWSAuth {
 declare const validateEnvironmentVars: () => ValidationResult;
 declare const initialiseS3Client: (auth?: AWSAuth | null) => S3Client;
 declare const initialiseLambdaClient: (auth?: AWSAuth | null) => Lambda;
-export { validateEnvironmentVars, initialiseS3Client, initialiseLambdaClient, AWSAuth };
+/**
+ * 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 };

package/dist/types/utils/circuit-breaker.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Possible states for a circuit breaker
+ */
+export declare enum CircuitBreakerState {
+    CLOSED = "CLOSED",
+    OPEN = "OPEN",
+    HALF_OPEN = "HALF_OPEN"
+}
+/**
+ * Configuration for the circuit breaker
+ */
+export interface CircuitBreakerConfig {
+    /** Number of failures before the circuit opens (default: 5) */
+    failureThreshold: number;
+    /** Time in milliseconds before attempting recovery from OPEN state (default: 30000) */
+    resetTimeoutMs: number;
+    /** Number of consecutive successes in HALF_OPEN required to close the circuit (default: 3) */
+    successThreshold: number;
+}
+/**
+ * Callback invoked when the circuit breaker changes state
+ */
+export type CircuitBreakerStateChangeCallback = (from: CircuitBreakerState, to: CircuitBreakerState, serviceName: string) => void;
+/**
+ * Default circuit breaker configuration
+ */
+export declare const DEFAULT_CIRCUIT_BREAKER_CONFIG: CircuitBreakerConfig;
+/**
+ * Error thrown when a circuit breaker is open and rejecting calls
+ */
+export declare class CircuitBreakerOpenError extends Error {
+    readonly serviceName: string;
+    readonly resetTimeoutMs: number;
+    constructor(serviceName: string, resetTimeoutMs: number);
+}
+/**
+ * Generic circuit breaker implementation for external service calls.
+ *
+ * The circuit breaker monitors failures and transitions through three states:
+ * - CLOSED: Normal operation. Calls pass through. Failures are counted.
+ * - OPEN: Too many failures. Calls are rejected immediately without executing.
+ * - HALF_OPEN: After a reset timeout, allows a limited number of trial calls
+ *   to test whether the service has recovered.
+ *
+ * @example
+ * const breaker = new CircuitBreaker('slack-api');
+ * const result = await breaker.execute(() => sendSlackMessage(channel, msg));
+ */
+export declare class CircuitBreaker {
+    readonly serviceName: string;
+    private state;
+    private failureCount;
+    private successCount;
+    private lastFailureTime;
+    private readonly config;
+    private onStateChange;
+    constructor(serviceName: string, config?: Partial<CircuitBreakerConfig>, onStateChange?: CircuitBreakerStateChangeCallback);
+    /**
+     * Returns the current state of the circuit breaker.
+     */
+    getState(): CircuitBreakerState;
+    /**
+     * Returns the current failure count.
+     */
+    getFailureCount(): number;
+    /**
+     * Returns the current success count (relevant in HALF_OPEN state).
+     */
+    getSuccessCount(): number;
+    /**
+     * Resets the circuit breaker to its initial CLOSED state.
+     */
+    reset(): void;
+    /**
+     * Executes the provided function through the circuit breaker.
+     *
+     * - In CLOSED state: executes normally, tracking failures.
+     * - In OPEN state: rejects immediately with CircuitBreakerOpenError
+     *   unless the reset timeout has elapsed, in which case it transitions to HALF_OPEN.
+     * - In HALF_OPEN state: allows trial calls, tracking successes to decide
+     *   whether to close or re-open the circuit.
+     *
+     * @template T - The return type of the wrapped function
+     * @param fn - The async function to execute
+     * @returns The result of the function call
+     * @throws CircuitBreakerOpenError if the circuit is open
+     * @throws The original error if the function call fails
+     */
+    execute<T>(fn: () => Promise<T>): Promise<T>;
+    /**
+     * Sets or replaces the state change callback.
+     */
+    setOnStateChange(callback: CircuitBreakerStateChangeCallback): void;
+    private shouldAttemptReset;
+    private onSuccess;
+    private onFailure;
+    private transitionTo;
+    private notifyStateChange;
+}

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

@@ -1,9 +1,47 @@
-import { OpenAIModel } from "../types";
-export declare const DEFAULT_MODEL: OpenAIModel;
+import { LLMModel, LLMProvider } from '../types';
+/**
+ * The default LLM provider, resolved from LLM_DEFAULT_PROVIDER env var.
+ * Falls back to 'openai'.
+ */
+export declare const LLM_DEFAULT_PROVIDER: LLMProvider;
+/**
+ * Per-tier provider overrides. Each falls back to LLM_DEFAULT_PROVIDER.
+ */
+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_PROVIDER: LLMProvider;
+/**
+ * The default model to use when no model is specified.
+ * Resolution order: AI_MODEL env var → default provider's normal tier
+ */
+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)
+ *   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
+ */
+export declare const LLM_MODEL_MINI: LLMModel;
+export declare const LLM_MODEL_NORMAL: LLMModel;
+export declare const LLM_MODEL_ADVANCED: LLMModel;
 export declare const PERPLEXITY_MODEL: string;
 export declare const PERPLEXITY_API_URL = "https://api.perplexity.ai/chat/completions";
 export interface Config {
     DEFAULT_MODEL: string;
+    LLM_DEFAULT_PROVIDER: LLMProvider;
+    LLM_MINI_PROVIDER: LLMProvider;
+    LLM_NORMAL_PROVIDER: LLMProvider;
+    LLM_ADVANCED_PROVIDER: LLMProvider;
+    LLM_MODEL_MINI: string;
+    LLM_MODEL_NORMAL: string;
+    LLM_MODEL_ADVANCED: string;
     PERPLEXITY_MODEL: string;
     PERPLEXITY_API_URL: string;
 }

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

@@ -0,0 +1,43 @@
+/**
+ * Correlation context stored in AsyncLocalStorage.
+ * Propagates automatically through async call chains.
+ */
+export interface CorrelationContext {
+    /** Unique correlation ID for request tracing */
+    correlationId: string;
+    /** Additional metadata to propagate */
+    metadata?: Record<string, string>;
+}
+/**
+ * Generates a new unique correlation ID.
+ * Uses crypto.randomUUID for high-quality UUIDs.
+ * @returns A new UUID string
+ */
+export declare function generateCorrelationId(): string;
+/**
+ * Returns the current correlation ID from AsyncLocalStorage, or undefined if none is set.
+ * @returns The current correlation ID or undefined
+ */
+export declare function getCorrelationId(): string | undefined;
+/**
+ * Returns the full correlation context, or undefined if none is set.
+ * @returns The current CorrelationContext or undefined
+ */
+export declare function getCorrelationContext(): CorrelationContext | undefined;
+/**
+ * Runs a function within a correlation context.
+ * All async operations within the callback will have access to the correlation ID.
+ *
+ * @param fn - The function to run within the context
+ * @param correlationId - Optional correlation ID. If not provided, one is generated.
+ * @param metadata - Optional metadata to attach to the context
+ * @returns The return value of the function
+ */
+export declare function withCorrelationId<T>(fn: () => T, correlationId?: string, metadata?: Record<string, string>): T;
+/**
+ * Returns headers object with the correlation ID for external HTTP calls.
+ * Returns an empty object if no correlation context is active.
+ * @param headerName - The header name to use (default: 'x-correlation-id')
+ * @returns Headers object with correlation ID
+ */
+export declare function getCorrelationHeaders(headerName?: string): Record<string, string>;