@xynehq/jaf 0.1.2

package/dist/adk/providers/error-handler.js

@@ -0,0 +1,289 @@
+/**
+ * JAF ADK Layer - LLM Error Handling
+ *
+ * Comprehensive error handling for LLM API failures following JAF patterns
+ */
+import { createAdkError } from '../types.js';
+// ========== Error Classifications ==========
+export const LLM_ERROR_TYPES = {
+    // Authentication errors
+    INVALID_API_KEY: 'INVALID_API_KEY',
+    UNAUTHORIZED: 'UNAUTHORIZED',
+    QUOTA_EXCEEDED: 'QUOTA_EXCEEDED',
+    // Request errors
+    INVALID_REQUEST: 'INVALID_REQUEST',
+    MODEL_NOT_FOUND: 'MODEL_NOT_FOUND',
+    UNSUPPORTED_MODEL: 'UNSUPPORTED_MODEL',
+    INVALID_PARAMETERS: 'INVALID_PARAMETERS',
+    // Rate limiting
+    RATE_LIMITED: 'RATE_LIMITED',
+    CONCURRENT_LIMIT: 'CONCURRENT_LIMIT',
+    // Service errors
+    SERVICE_UNAVAILABLE: 'SERVICE_UNAVAILABLE',
+    TIMEOUT: 'TIMEOUT',
+    NETWORK_ERROR: 'NETWORK_ERROR',
+    // Content errors
+    CONTENT_FILTERED: 'CONTENT_FILTERED',
+    CONTENT_TOO_LONG: 'CONTENT_TOO_LONG',
+    // Function calling errors
+    FUNCTION_CALL_ERROR: 'FUNCTION_CALL_ERROR',
+    FUNCTION_NOT_FOUND: 'FUNCTION_NOT_FOUND',
+    // Unknown errors
+    UNKNOWN_ERROR: 'UNKNOWN_ERROR'
+};
+export const RETRYABLE_ERRORS = new Set([
+    LLM_ERROR_TYPES.RATE_LIMITED,
+    LLM_ERROR_TYPES.SERVICE_UNAVAILABLE,
+    LLM_ERROR_TYPES.TIMEOUT,
+    LLM_ERROR_TYPES.NETWORK_ERROR,
+    LLM_ERROR_TYPES.CONCURRENT_LIMIT
+]);
+// ========== Error Factory Functions ==========
+export const createLLMError = (message, code, context) => ({
+    ...createAdkError(message, code, context),
+    name: 'LLMError',
+    provider: context?.provider,
+    model: context?.model,
+    retryable: RETRYABLE_ERRORS.has(code),
+    statusCode: context?.statusCode,
+    responseBody: context?.responseBody
+});
+export const createLLMTimeoutError = (provider, model, timeout) => createLLMError(`LLM request timed out after ${timeout}ms`, LLM_ERROR_TYPES.TIMEOUT, { provider, model });
+export const createLLMRateLimitError = (provider, model, resetTime) => createLLMError(`Rate limit exceeded for ${provider}/${model}${resetTime ? `. Resets in ${resetTime}ms` : ''}`, LLM_ERROR_TYPES.RATE_LIMITED, { provider, model });
+export const createLLMQuotaError = (provider, model) => createLLMError(`Quota exceeded for ${provider}/${model}`, LLM_ERROR_TYPES.QUOTA_EXCEEDED, { provider, model });
+export const createLLMContentFilterError = (provider, model) => createLLMError(`Content filtered by ${provider}/${model}`, LLM_ERROR_TYPES.CONTENT_FILTERED, { provider, model });
+// ========== Error Classification ==========
+export const classifyLLMError = (error, provider, model) => {
+    const message = error.message.toLowerCase();
+    // Authentication errors
+    if (message.includes('api key') || message.includes('unauthorized') || message.includes('invalid key')) {
+        return createLLMError(error.message, LLM_ERROR_TYPES.INVALID_API_KEY, { provider, model });
+    }
+    if (message.includes('quota') || message.includes('billing')) {
+        return createLLMError(error.message, LLM_ERROR_TYPES.QUOTA_EXCEEDED, { provider, model });
+    }
+    // Rate limiting
+    if (message.includes('rate limit') || message.includes('too many requests')) {
+        return createLLMError(error.message, LLM_ERROR_TYPES.RATE_LIMITED, { provider, model });
+    }
+    // Model errors
+    if (message.includes('model') && (message.includes('not found') || message.includes('not available'))) {
+        return createLLMError(error.message, LLM_ERROR_TYPES.MODEL_NOT_FOUND, { provider, model });
+    }
+    // Timeout errors
+    if (message.includes('timeout') || message.includes('timed out')) {
+        return createLLMError(error.message, LLM_ERROR_TYPES.TIMEOUT, { provider, model });
+    }
+    // Network errors
+    if (message.includes('network') || message.includes('connection') || message.includes('fetch')) {
+        return createLLMError(error.message, LLM_ERROR_TYPES.NETWORK_ERROR, { provider, model });
+    }
+    // Service errors
+    if (message.includes('service unavailable') || message.includes('server error') || message.includes('503')) {
+        return createLLMError(error.message, LLM_ERROR_TYPES.SERVICE_UNAVAILABLE, { provider, model });
+    }
+    // Content filtering
+    if (message.includes('content') && (message.includes('filter') || message.includes('policy'))) {
+        return createLLMError(error.message, LLM_ERROR_TYPES.CONTENT_FILTERED, { provider, model });
+    }
+    // Content too long
+    if (message.includes('too long') || message.includes('token limit') || message.includes('context length')) {
+        return createLLMError(error.message, LLM_ERROR_TYPES.CONTENT_TOO_LONG, { provider, model });
+    }
+    // Function calling errors
+    if (message.includes('function') || message.includes('tool')) {
+        return createLLMError(error.message, LLM_ERROR_TYPES.FUNCTION_CALL_ERROR, { provider, model });
+    }
+    // Default to unknown error
+    return createLLMError(error.message, LLM_ERROR_TYPES.UNKNOWN_ERROR, { provider, model });
+};
+// ========== Retry Logic ==========
+export const DEFAULT_RETRY_CONFIG = {
+    maxRetries: 3,
+    baseDelay: 1000,
+    maxDelay: 30000,
+    retryableErrors: [
+        LLM_ERROR_TYPES.RATE_LIMITED,
+        LLM_ERROR_TYPES.SERVICE_UNAVAILABLE,
+        LLM_ERROR_TYPES.TIMEOUT,
+        LLM_ERROR_TYPES.NETWORK_ERROR,
+        LLM_ERROR_TYPES.CONCURRENT_LIMIT
+    ]
+};
+export const shouldRetryError = (error, config = DEFAULT_RETRY_CONFIG) => {
+    return error.retryable === true && config.retryableErrors.includes(error.code);
+};
+export const calculateRetryDelay = (attempt, config = DEFAULT_RETRY_CONFIG, jitter = true) => {
+    const exponentialDelay = config.baseDelay * Math.pow(2, attempt);
+    const cappedDelay = Math.min(exponentialDelay, config.maxDelay);
+    if (jitter) {
+        // Add random jitter to prevent thundering herd
+        return cappedDelay * (0.5 + Math.random() * 0.5);
+    }
+    return cappedDelay;
+};
+// ========== Retry Wrapper ==========
+export const withLLMRetry = (fn, config = {}, provider = 'unknown', model = 'unknown') => {
+    const retryConfig = { ...DEFAULT_RETRY_CONFIG, ...config };
+    return async (...args) => {
+        let lastError;
+        for (let attempt = 0; attempt <= retryConfig.maxRetries; attempt++) {
+            try {
+                return await fn(...args);
+            }
+            catch (error) {
+                lastError = error instanceof Error
+                    ? classifyLLMError(error, provider, model)
+                    : createLLMError(String(error), LLM_ERROR_TYPES.UNKNOWN_ERROR, { provider, model });
+                if (attempt === retryConfig.maxRetries || !shouldRetryError(lastError, retryConfig)) {
+                    throw lastError;
+                }
+                const delay = calculateRetryDelay(attempt, retryConfig);
+                console.warn(`[ADK:LLM] Attempt ${attempt + 1} failed, retrying in ${delay}ms:`, lastError.message);
+                await new Promise(resolve => setTimeout(resolve, delay));
+            }
+        }
+        throw lastError;
+    };
+};
+// ========== Timeout Wrapper ==========
+export const withLLMTimeout = (fn, timeoutMs, provider = 'unknown', model = 'unknown') => {
+    return async (...args) => {
+        const timeoutPromise = new Promise((_, reject) => {
+            setTimeout(() => {
+                reject(createLLMTimeoutError(provider, model, timeoutMs));
+            }, timeoutMs);
+        });
+        return Promise.race([
+            fn(...args),
+            timeoutPromise
+        ]);
+    };
+};
+export const createCircuitBreaker = (fn, config, provider = 'unknown', model = 'unknown') => {
+    const state = {
+        failures: 0,
+        lastFailureTime: 0,
+        state: 'closed'
+    };
+    return async (...args) => {
+        const now = Date.now();
+        // Check if we should reset from open to half-open
+        if (state.state === 'open' && now - state.lastFailureTime >= config.resetTimeout) {
+            state.state = 'half-open';
+            console.log(`[ADK:LLM] Circuit breaker ${provider}/${model} moving to half-open`);
+        }
+        // Reject immediately if circuit is open
+        if (state.state === 'open') {
+            throw createLLMError(`Circuit breaker open for ${provider}/${model}`, LLM_ERROR_TYPES.SERVICE_UNAVAILABLE, { provider, model });
+        }
+        try {
+            const result = await fn(...args);
+            // Success - reset circuit breaker
+            if (state.state === 'half-open') {
+                state.state = 'closed';
+                state.failures = 0;
+                console.log(`[ADK:LLM] Circuit breaker ${provider}/${model} reset to closed`);
+            }
+            return result;
+        }
+        catch (error) {
+            state.failures++;
+            state.lastFailureTime = now;
+            // Open circuit if threshold exceeded
+            if (state.failures >= config.failureThreshold) {
+                state.state = 'open';
+                console.warn(`[ADK:LLM] Circuit breaker ${provider}/${model} opened after ${state.failures} failures`);
+            }
+            throw error;
+        }
+    };
+};
+// ========== Error Recovery Strategies ==========
+export const createFallbackStrategy = (primaryFn, fallbackFn, shouldFallback = () => true) => {
+    return async (...args) => {
+        try {
+            return await primaryFn(...args);
+        }
+        catch (error) {
+            const llmError = error instanceof Error
+                ? classifyLLMError(error, 'unknown', 'unknown')
+                : createLLMError(String(error), LLM_ERROR_TYPES.UNKNOWN_ERROR);
+            if (shouldFallback(llmError)) {
+                console.warn(`[ADK:LLM] Primary function failed, using fallback:`, llmError.message);
+                return await fallbackFn(...args);
+            }
+            throw llmError;
+        }
+    };
+};
+export const createLLMErrorMonitor = () => {
+    const metrics = {
+        totalErrors: 0,
+        errorsByType: {},
+        errorsByProvider: {},
+        errorsByModel: {}
+    };
+    const recordError = (error) => {
+        metrics.totalErrors++;
+        metrics.errorsByType[error.code] = (metrics.errorsByType[error.code] || 0) + 1;
+        if (error.provider) {
+            metrics.errorsByProvider[error.provider] = (metrics.errorsByProvider[error.provider] || 0) + 1;
+        }
+        if (error.model) {
+            metrics.errorsByModel[error.model] = (metrics.errorsByModel[error.model] || 0) + 1;
+        }
+        metrics.lastError = error;
+        metrics.lastErrorTime = Date.now();
+    };
+    const getMetrics = () => ({ ...metrics });
+    const resetMetrics = () => {
+        metrics.totalErrors = 0;
+        metrics.errorsByType = {};
+        metrics.errorsByProvider = {};
+        metrics.errorsByModel = {};
+        delete metrics.lastError;
+        delete metrics.lastErrorTime;
+    };
+    return {
+        recordError,
+        getMetrics,
+        resetMetrics
+    };
+};
+export const createLLMErrorLogger = () => ({
+    logError: (error, context) => {
+        console.error(`[ADK:LLM:ERROR] ${error.code}: ${error.message}`, {
+            provider: error.provider,
+            model: error.model,
+            retryable: error.retryable,
+            statusCode: error.statusCode,
+            context
+        });
+    },
+    logRetry: (error, attempt, delay) => {
+        console.warn(`[ADK:LLM:RETRY] Attempt ${attempt} failed: ${error.message}. Retrying in ${delay}ms`, {
+            provider: error.provider,
+            model: error.model,
+            code: error.code
+        });
+    },
+    logRecovery: (error, recoveryMethod) => {
+        console.info(`[ADK:LLM:RECOVERY] Recovered from error using ${recoveryMethod}: ${error.message}`, {
+            provider: error.provider,
+            model: error.model,
+            code: error.code
+        });
+    }
+});
+// ========== Default Export ==========
+export const defaultLLMErrorHandler = {
+    classify: classifyLLMError,
+    retry: withLLMRetry,
+    timeout: withLLMTimeout,
+    fallback: createFallbackStrategy,
+    circuitBreaker: createCircuitBreaker,
+    monitor: createLLMErrorMonitor(),
+    logger: createLLMErrorLogger()
+};
+//# sourceMappingURL=error-handler.js.map

package/dist/adk/providers/error-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.js","sourceRoot":"","sources":["../../../src/adk/providers/error-handler.ts"],"names":[],"mappings":"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"}

package/dist/adk/providers/llm-service.d.ts

@@ -0,0 +1,41 @@
+/**
+ * JAF ADK Layer - LLM Service Bridge
+ *
+ * Bridges ADK types to Core ModelProvider interface following functional patterns
+ */
+import { Agent, Content, Session, FunctionCall } from '../types.js';
+export interface AdkLLMServiceConfig {
+    provider: 'litellm' | 'openai' | 'anthropic' | 'google';
+    baseUrl?: string;
+    apiKey?: string;
+    defaultModel?: string;
+}
+export interface AdkLLMResponse {
+    content: Content;
+    functionCalls: FunctionCall[];
+    metadata: {
+        model: string;
+        tokensUsed?: number;
+        finishReason?: string;
+    };
+}
+export interface AdkLLMStreamChunk {
+    delta: string;
+    functionCall?: Partial<FunctionCall>;
+    isDone: boolean;
+}
+export type AdkLLMService = {
+    generateResponse: (agent: Agent, session: Session, message: Content, requestConfig?: {
+        modelOverride?: string;
+        temperature?: number;
+        maxTokens?: number;
+    }) => Promise<AdkLLMResponse>;
+    generateStreamingResponse: (agent: Agent, session: Session, message: Content, requestConfig?: {
+        modelOverride?: string;
+        temperature?: number;
+        maxTokens?: number;
+    }) => AsyncGenerator<AdkLLMStreamChunk>;
+};
+export declare const createAdkLLMService: (config: AdkLLMServiceConfig) => AdkLLMService;
+export declare const createDefaultAdkLLMService: () => AdkLLMService;
+//# sourceMappingURL=llm-service.d.ts.map

package/dist/adk/providers/llm-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-service.d.ts","sourceRoot":"","sources":["../../../src/adk/providers/llm-service.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EACL,KAAK,EACL,OAAO,EACP,OAAO,EAEP,YAAY,EAKb,MAAM,aAAa,CAAC;AAKrB,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,QAAQ,EAAE;QACR,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IACrC,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,gBAAgB,EAAE,CAChB,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,EAChB,aAAa,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,KACjF,OAAO,CAAC,cAAc,CAAC,CAAC;IAE7B,yBAAyB,EAAE,CACzB,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,EAChB,aAAa,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,KACjF,cAAc,CAAC,iBAAiB,CAAC,CAAC;CACxC,CAAC;AAIF,eAAO,MAAM,mBAAmB,GAAI,QAAQ,mBAAmB,KAAG,aAoDjE,CAAC;AAyjBF,eAAO,MAAM,0BAA0B,QAAO,aAO7C,CAAC"}