@cogitator-ai/core 0.1.0

package/dist/tools/sleep.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Sleep tool - pause execution for a specified duration
+ */
+export declare const sleep: import("@cogitator-ai/types").Tool<{
+    ms: number;
+}, {
+    slept: number;
+    requested: number;
+}>;
+//# sourceMappingURL=sleep.d.ts.map

package/dist/tools/sleep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.d.ts","sourceRoot":"","sources":["../../src/tools/sleep.ts"],"names":[],"mappings":"AAAA;;GAEG;AAcH,eAAO,MAAM,KAAK;;;;;EAWhB,CAAC"}

package/dist/tools/sleep.js

@@ -0,0 +1,25 @@
+/**
+ * Sleep tool - pause execution for a specified duration
+ */
+import { z } from 'zod';
+import { tool } from '../tool';
+const sleepParams = z.object({
+    ms: z
+        .number()
+        .int()
+        .min(0)
+        .max(60000)
+        .describe('Duration to sleep in milliseconds (max: 60000 = 1 minute)'),
+});
+export const sleep = tool({
+    name: 'sleep',
+    description: 'Pause execution for a specified number of milliseconds. Useful for rate limiting or waiting between operations. Maximum: 60 seconds.',
+    parameters: sleepParams,
+    execute: async ({ ms }) => {
+        const start = Date.now();
+        await new Promise((resolve) => setTimeout(resolve, ms));
+        const actual = Date.now() - start;
+        return { slept: actual, requested: ms };
+    },
+});
+//# sourceMappingURL=sleep.js.map

package/dist/tools/sleep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.js","sourceRoot":"","sources":["../../src/tools/sleep.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,EAAE,EAAE,CAAC;SACF,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,KAAK,CAAC;SACV,QAAQ,CAAC,2DAA2D,CAAC;CACzE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,OAAO;IACb,WAAW,EACT,sIAAsI;IACxI,UAAU,EAAE,WAAW;IACvB,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;QACxB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;QACxD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QAClC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IAC1C,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/uuid.d.ts

@@ -0,0 +1,15 @@
+/**
+ * UUID tool - generates UUID v4
+ */
+export declare const uuid: import("@cogitator-ai/types").Tool<{
+    count?: number | undefined;
+}, {
+    uuid: `${string}-${string}-${string}-${string}-${string}`;
+    uuids?: undefined;
+    count?: undefined;
+} | {
+    uuids: `${string}-${string}-${string}-${string}-${string}`[];
+    count: number;
+    uuid?: undefined;
+}>;
+//# sourceMappingURL=uuid.d.ts.map

package/dist/tools/uuid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.d.ts","sourceRoot":"","sources":["../../src/tools/uuid.ts"],"names":[],"mappings":"AAAA;;GAEG;AAgBH,eAAO,MAAM,IAAI;;;;;;;;;;EAQf,CAAC"}

package/dist/tools/uuid.js

@@ -0,0 +1,25 @@
+/**
+ * UUID tool - generates UUID v4
+ */
+import { randomUUID } from 'node:crypto';
+import { z } from 'zod';
+import { tool } from '../tool';
+const uuidParams = z.object({
+    count: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .optional()
+        .describe('Number of UUIDs to generate (default: 1, max: 100)'),
+});
+export const uuid = tool({
+    name: 'uuid',
+    description: 'Generate one or more UUID v4 identifiers.',
+    parameters: uuidParams,
+    execute: async ({ count = 1 }) => {
+        const uuids = Array.from({ length: count }, () => randomUUID());
+        return count === 1 ? { uuid: uuids[0] } : { uuids, count };
+    },
+});
+//# sourceMappingURL=uuid.js.map

package/dist/tools/uuid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.js","sourceRoot":"","sources":["../../src/tools/uuid.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1B,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,oDAAoD,CAAC;CAClE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,IAAI,GAAG,IAAI,CAAC;IACvB,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,2CAA2C;IACxD,UAAU,EAAE,UAAU;IACtB,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,GAAG,CAAC,EAAE,EAAE,EAAE;QAC/B,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC;QAChE,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAC7D,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,127 @@
+/**
+ * Circuit Breaker pattern implementation
+ *
+ * Prevents cascading failures by failing fast when a service is unhealthy.
+ * States:
+ * - CLOSED: Normal operation, requests pass through
+ * - OPEN: Service is failing, requests fail immediately
+ * - HALF_OPEN: Testing if service recovered
+ */
+export type CircuitState = 'closed' | 'open' | 'half-open';
+export interface CircuitBreakerOptions {
+    /** Number of failures before opening circuit (default: 5) */
+    failureThreshold?: number;
+    /** Time in ms before trying again after opening (default: 30000) */
+    resetTimeout?: number;
+    /** Max requests allowed in half-open state (default: 3) */
+    halfOpenRequests?: number;
+    /** Function to determine if error should count as failure */
+    isFailure?: (error: Error) => boolean;
+    /** Called when state changes */
+    onStateChange?: (from: CircuitState, to: CircuitState) => void;
+}
+export interface CircuitBreakerStats {
+    state: CircuitState;
+    failures: number;
+    successes: number;
+    totalRequests: number;
+    lastFailure?: Date;
+    lastSuccess?: Date;
+}
+/**
+ * Circuit Breaker for protecting external service calls
+ *
+ * @example
+ * ```typescript
+ * const breaker = new CircuitBreaker({
+ *   failureThreshold: 5,
+ *   resetTimeout: 30000,
+ *   onStateChange: (from, to) => {
+ *     console.log(`Circuit ${from} -> ${to}`);
+ *   },
+ * });
+ *
+ * try {
+ *   const result = await breaker.execute(() => callExternalService());
+ * } catch (error) {
+ *   if (error.code === ErrorCode.CIRCUIT_OPEN) {
+ *     // Circuit is open, service is unhealthy
+ *   }
+ * }
+ * ```
+ */
+export declare class CircuitBreaker {
+    private state;
+    private failures;
+    private successes;
+    private totalRequests;
+    private halfOpenRequests;
+    private lastFailure?;
+    private lastSuccess?;
+    private openedAt?;
+    private readonly options;
+    private readonly isFailure;
+    private readonly onStateChange?;
+    constructor(options?: CircuitBreakerOptions);
+    /**
+     * Get current circuit state
+     */
+    getState(): CircuitState;
+    /**
+     * Get circuit statistics
+     */
+    getStats(): CircuitBreakerStats;
+    /**
+     * Check if circuit should transition from open to half-open
+     */
+    private shouldAttemptReset;
+    /**
+     * Transition to a new state
+     */
+    private transitionTo;
+    /**
+     * Record a successful call
+     */
+    private recordSuccess;
+    /**
+     * Record a failed call
+     */
+    private recordFailure;
+    /**
+     * Execute a function through the circuit breaker
+     */
+    execute<T>(fn: () => Promise<T>): Promise<T>;
+    /**
+     * Force circuit to open state
+     */
+    open(): void;
+    /**
+     * Force circuit to closed state
+     */
+    close(): void;
+    /**
+     * Reset circuit to initial state
+     */
+    reset(): void;
+}
+/**
+ * Registry for managing multiple circuit breakers
+ */
+export declare class CircuitBreakerRegistry {
+    private breakers;
+    private readonly defaultOptions;
+    constructor(defaultOptions?: CircuitBreakerOptions);
+    /**
+     * Get or create a circuit breaker by name
+     */
+    get(name: string, options?: CircuitBreakerOptions): CircuitBreaker;
+    /**
+     * Get all circuit breaker states
+     */
+    getAllStats(): Record<string, CircuitBreakerStats>;
+    /**
+     * Reset all circuit breakers
+     */
+    resetAll(): void;
+}
+//# sourceMappingURL=circuit-breaker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.d.ts","sourceRoot":"","sources":["../../src/utils/circuit-breaker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAE3D,MAAM,WAAW,qBAAqB;IACpC,6DAA6D;IAC7D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,6DAA6D;IAC7D,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC;IACtC,gCAAgC;IAChC,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,YAAY,KAAK,IAAI,CAAC;CAChE;AAQD,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,WAAW,CAAC,EAAE,IAAI,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,WAAW,CAAC,CAAO;IAC3B,OAAO,CAAC,WAAW,CAAC,CAAO;IAC3B,OAAO,CAAC,QAAQ,CAAC,CAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuE;IAC/F,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4B;IACtD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAiD;gBAEpE,OAAO,GAAE,qBAA0B;IAM/C;;OAEG;IACH,QAAQ,IAAI,YAAY;IAIxB;;OAEG;IACH,QAAQ,IAAI,mBAAmB;IAW/B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAQ1B;;OAEG;IACH,OAAO,CAAC,YAAY;IAmBpB;;OAEG;IACH,OAAO,CAAC,aAAa;IAerB;;OAEG;IACH,OAAO,CAAC,aAAa;IAcrB;;OAEG;IACG,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAoClD;;OAEG;IACH,IAAI,IAAI,IAAI;IAIZ;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,KAAK,IAAI,IAAI;CAUd;AAED;;GAEG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAwB;gBAE3C,cAAc,GAAE,qBAA0B;IAItD;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,cAAc;IASlE;;OAEG;IACH,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC;IAQlD;;OAEG;IACH,QAAQ,IAAI,IAAI;CAKjB"}

package/dist/utils/circuit-breaker.js

@@ -0,0 +1,235 @@
+/**
+ * Circuit Breaker pattern implementation
+ *
+ * Prevents cascading failures by failing fast when a service is unhealthy.
+ * States:
+ * - CLOSED: Normal operation, requests pass through
+ * - OPEN: Service is failing, requests fail immediately
+ * - HALF_OPEN: Testing if service recovered
+ */
+import { CogitatorError, ErrorCode, isRetryableError } from '@cogitator-ai/types';
+const DEFAULT_OPTIONS = {
+    failureThreshold: 5,
+    resetTimeout: 30000,
+    halfOpenRequests: 3,
+};
+/**
+ * Circuit Breaker for protecting external service calls
+ *
+ * @example
+ * ```typescript
+ * const breaker = new CircuitBreaker({
+ *   failureThreshold: 5,
+ *   resetTimeout: 30000,
+ *   onStateChange: (from, to) => {
+ *     console.log(`Circuit ${from} -> ${to}`);
+ *   },
+ * });
+ *
+ * try {
+ *   const result = await breaker.execute(() => callExternalService());
+ * } catch (error) {
+ *   if (error.code === ErrorCode.CIRCUIT_OPEN) {
+ *     // Circuit is open, service is unhealthy
+ *   }
+ * }
+ * ```
+ */
+export class CircuitBreaker {
+    state = 'closed';
+    failures = 0;
+    successes = 0;
+    totalRequests = 0;
+    halfOpenRequests = 0;
+    lastFailure;
+    lastSuccess;
+    openedAt;
+    options;
+    isFailure;
+    onStateChange;
+    constructor(options = {}) {
+        this.options = { ...DEFAULT_OPTIONS, ...options };
+        this.isFailure = options.isFailure ?? isRetryableError;
+        this.onStateChange = options.onStateChange;
+    }
+    /**
+     * Get current circuit state
+     */
+    getState() {
+        return this.state;
+    }
+    /**
+     * Get circuit statistics
+     */
+    getStats() {
+        return {
+            state: this.state,
+            failures: this.failures,
+            successes: this.successes,
+            totalRequests: this.totalRequests,
+            lastFailure: this.lastFailure,
+            lastSuccess: this.lastSuccess,
+        };
+    }
+    /**
+     * Check if circuit should transition from open to half-open
+     */
+    shouldAttemptReset() {
+        if (this.state !== 'open' || !this.openedAt) {
+            return false;
+        }
+        const elapsed = Date.now() - this.openedAt.getTime();
+        return elapsed >= this.options.resetTimeout;
+    }
+    /**
+     * Transition to a new state
+     */
+    transitionTo(newState) {
+        if (this.state === newState)
+            return;
+        const oldState = this.state;
+        this.state = newState;
+        if (newState === 'open') {
+            this.openedAt = new Date();
+            this.halfOpenRequests = 0;
+        }
+        else if (newState === 'closed') {
+            this.failures = 0;
+            this.halfOpenRequests = 0;
+        }
+        else if (newState === 'half-open') {
+            this.halfOpenRequests = 0;
+        }
+        this.onStateChange?.(oldState, newState);
+    }
+    /**
+     * Record a successful call
+     */
+    recordSuccess() {
+        this.successes++;
+        this.lastSuccess = new Date();
+        if (this.state === 'half-open') {
+            this.halfOpenRequests++;
+            if (this.halfOpenRequests >= this.options.halfOpenRequests) {
+                this.transitionTo('closed');
+            }
+        }
+        else if (this.state === 'closed') {
+            this.failures = 0;
+        }
+    }
+    /**
+     * Record a failed call
+     */
+    recordFailure() {
+        this.failures++;
+        this.lastFailure = new Date();
+        if (this.state === 'half-open') {
+            this.transitionTo('open');
+        }
+        else if (this.state === 'closed') {
+            if (this.failures >= this.options.failureThreshold) {
+                this.transitionTo('open');
+            }
+        }
+    }
+    /**
+     * Execute a function through the circuit breaker
+     */
+    async execute(fn) {
+        this.totalRequests++;
+        if (this.shouldAttemptReset()) {
+            this.transitionTo('half-open');
+        }
+        if (this.state === 'open') {
+            throw new CogitatorError({
+                message: 'Circuit breaker is open',
+                code: ErrorCode.CIRCUIT_OPEN,
+                retryable: true,
+                retryAfter: this.options.resetTimeout,
+                details: {
+                    state: this.state,
+                    failures: this.failures,
+                    lastFailure: this.lastFailure?.toISOString(),
+                },
+            });
+        }
+        try {
+            const result = await fn();
+            this.recordSuccess();
+            return result;
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            if (this.isFailure(err)) {
+                this.recordFailure();
+            }
+            throw error;
+        }
+    }
+    /**
+     * Force circuit to open state
+     */
+    open() {
+        this.transitionTo('open');
+    }
+    /**
+     * Force circuit to closed state
+     */
+    close() {
+        this.transitionTo('closed');
+    }
+    /**
+     * Reset circuit to initial state
+     */
+    reset() {
+        this.state = 'closed';
+        this.failures = 0;
+        this.successes = 0;
+        this.totalRequests = 0;
+        this.halfOpenRequests = 0;
+        this.lastFailure = undefined;
+        this.lastSuccess = undefined;
+        this.openedAt = undefined;
+    }
+}
+/**
+ * Registry for managing multiple circuit breakers
+ */
+export class CircuitBreakerRegistry {
+    breakers = new Map();
+    defaultOptions;
+    constructor(defaultOptions = {}) {
+        this.defaultOptions = defaultOptions;
+    }
+    /**
+     * Get or create a circuit breaker by name
+     */
+    get(name, options) {
+        let breaker = this.breakers.get(name);
+        if (!breaker) {
+            breaker = new CircuitBreaker({ ...this.defaultOptions, ...options });
+            this.breakers.set(name, breaker);
+        }
+        return breaker;
+    }
+    /**
+     * Get all circuit breaker states
+     */
+    getAllStats() {
+        const stats = {};
+        for (const [name, breaker] of this.breakers) {
+            stats[name] = breaker.getStats();
+        }
+        return stats;
+    }
+    /**
+     * Reset all circuit breakers
+     */
+    resetAll() {
+        for (const breaker of this.breakers.values()) {
+            breaker.reset();
+        }
+    }
+}
+//# sourceMappingURL=circuit-breaker.js.map

package/dist/utils/circuit-breaker.js.map

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

package/dist/utils/fallback.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Fallback utilities for graceful degradation
+ */
+import { type CircuitBreakerRegistry } from './circuit-breaker';
+import { type RetryOptions } from './retry';
+/**
+ * Fallback chain configuration
+ */
+export interface FallbackConfig<T> {
+    /** Primary operation */
+    primary: () => Promise<T>;
+    /** Fallback operations in order of preference */
+    fallbacks: {
+        name: string;
+        fn: () => Promise<T>;
+    }[];
+    /** Retry options for each operation */
+    retry?: RetryOptions;
+    /** Circuit breaker registry for tracking failures */
+    circuitBreakers?: CircuitBreakerRegistry;
+    /** Called when falling back */
+    onFallback?: (from: string, to: string, error: Error) => void;
+}
+/**
+ * Execute with fallback chain
+ *
+ * @example
+ * ```typescript
+ * const result = await withFallback({
+ *   primary: () => ollamaBackend.chat(request),
+ *   fallbacks: [
+ *     { name: 'openai', fn: () => openaiBackend.chat(request) },
+ *     { name: 'anthropic', fn: () => anthropicBackend.chat(request) },
+ *   ],
+ *   retry: { maxRetries: 2 },
+ *   onFallback: (from, to, error) => {
+ *     console.warn(`Falling back from ${from} to ${to}: ${error.message}`);
+ *   },
+ * });
+ * ```
+ */
+export declare function withFallback<T>(config: FallbackConfig<T>): Promise<T>;
+/**
+ * LLM fallback chain configuration
+ */
+export interface LLMFallbackConfig {
+    providers: {
+        provider: string;
+        model: string;
+    }[];
+}
+/**
+ * Create an LLM request executor with automatic fallback
+ */
+export declare function createLLMFallbackExecutor(config: LLMFallbackConfig, circuitBreakers: CircuitBreakerRegistry): <T>(request: (provider: string, model: string) => Promise<T>, onFallback?: (from: string, to: string, error: Error) => void) => Promise<T>;
+/**
+ * Graceful degradation wrapper
+ *
+ * Returns a default value if operation fails after all retries
+ */
+export declare function withGracefulDegradation<T>(fn: () => Promise<T>, options: {
+    defaultValue: T;
+    retry?: RetryOptions;
+    onDegraded?: (error: Error) => void;
+}): Promise<T>;
+//# sourceMappingURL=fallback.d.ts.map

package/dist/utils/fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback.d.ts","sourceRoot":"","sources":["../../src/utils/fallback.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAa,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,wBAAwB;IACxB,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;IAC1B,iDAAiD;IACjD,SAAS,EAAE;QACT,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;KACtB,EAAE,CAAC;IACJ,uCAAuC;IACvC,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,qDAAqD;IACrD,eAAe,CAAC,EAAE,sBAAsB,CAAC;IACzC,+BAA+B;IAC/B,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAC/D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CA4C3E;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE;QACT,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;KACf,EAAE,CAAC;CACL;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,iBAAiB,EACzB,eAAe,EAAE,sBAAsB,IAEM,CAAC,EAC5C,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EACxD,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,KAC5D,OAAO,CAAC,CAAC,CAAC,CAcd;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAAC,CAAC,EAC7C,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,EAAE;IACP,YAAY,EAAE,CAAC,CAAC;IAChB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACrC,GACA,OAAO,CAAC,CAAC,CAAC,CAWZ"}

package/dist/utils/fallback.js

@@ -0,0 +1,99 @@
+/**
+ * Fallback utilities for graceful degradation
+ */
+import { CogitatorError, ErrorCode } from '@cogitator-ai/types';
+import { withRetry } from './retry';
+/**
+ * Execute with fallback chain
+ *
+ * @example
+ * ```typescript
+ * const result = await withFallback({
+ *   primary: () => ollamaBackend.chat(request),
+ *   fallbacks: [
+ *     { name: 'openai', fn: () => openaiBackend.chat(request) },
+ *     { name: 'anthropic', fn: () => anthropicBackend.chat(request) },
+ *   ],
+ *   retry: { maxRetries: 2 },
+ *   onFallback: (from, to, error) => {
+ *     console.warn(`Falling back from ${from} to ${to}: ${error.message}`);
+ *   },
+ * });
+ * ```
+ */
+export async function withFallback(config) {
+    const { primary, fallbacks, retry, circuitBreakers, onFallback } = config;
+    const operations = [
+        { name: 'primary', fn: primary },
+        ...fallbacks,
+    ];
+    let lastError;
+    for (let i = 0; i < operations.length; i++) {
+        const op = operations[i];
+        const breaker = circuitBreakers?.get(op.name);
+        try {
+            const execute = async () => {
+                if (breaker) {
+                    return breaker.execute(op.fn);
+                }
+                return op.fn();
+            };
+            if (retry) {
+                return await withRetry(execute, retry);
+            }
+            return await execute();
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            if (i < operations.length - 1) {
+                const nextOp = operations[i + 1];
+                onFallback?.(op.name, nextOp.name, lastError);
+            }
+        }
+    }
+    throw new CogitatorError({
+        message: `All fallback options exhausted: ${lastError?.message}`,
+        code: ErrorCode.INTERNAL_ERROR,
+        cause: lastError,
+        details: {
+            triedOperations: operations.map((op) => op.name),
+        },
+    });
+}
+/**
+ * Create an LLM request executor with automatic fallback
+ */
+export function createLLMFallbackExecutor(config, circuitBreakers) {
+    return async function executeLLMWithFallback(request, onFallback) {
+        const [primary, ...fallbacks] = config.providers;
+        return withFallback({
+            primary: () => request(primary.provider, primary.model),
+            fallbacks: fallbacks.map((fb) => ({
+                name: `${fb.provider}:${fb.model}`,
+                fn: () => request(fb.provider, fb.model),
+            })),
+            retry: { maxRetries: 2, baseDelay: 1000, backoff: 'exponential' },
+            circuitBreakers,
+            onFallback,
+        });
+    };
+}
+/**
+ * Graceful degradation wrapper
+ *
+ * Returns a default value if operation fails after all retries
+ */
+export async function withGracefulDegradation(fn, options) {
+    try {
+        if (options.retry) {
+            return await withRetry(fn, options.retry);
+        }
+        return await fn();
+    }
+    catch (error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        options.onDegraded?.(err);
+        return options.defaultValue;
+    }
+}
+//# sourceMappingURL=fallback.js.map

package/dist/utils/fallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback.js","sourceRoot":"","sources":["../../src/utils/fallback.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhE,OAAO,EAAE,SAAS,EAAqB,MAAM,SAAS,CAAC;AAqBvD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAI,MAAyB;IAC7D,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;IAE1E,MAAM,UAAU,GAAG;QACjB,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE;QAChC,GAAG,SAAS;KACb,CAAC;IAEF,IAAI,SAA4B,CAAC;IAEjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,MAAM,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,OAAO,GAAG,eAAe,EAAE,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;QAE9C,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,KAAK,IAAI,EAAE;gBACzB,IAAI,OAAO,EAAE,CAAC;oBACZ,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;gBAChC,CAAC;gBACD,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC;YACjB,CAAC,CAAC;YAEF,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO,MAAM,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YACzC,CAAC;YACD,OAAO,MAAM,OAAO,EAAE,CAAC;QACzB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAEtE,IAAI,CAAC,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9B,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBACjC,UAAU,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,IAAI,cAAc,CAAC;QACvB,OAAO,EAAE,mCAAmC,SAAS,EAAE,OAAO,EAAE;QAChE,IAAI,EAAE,SAAS,CAAC,cAAc;QAC9B,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE;YACP,eAAe,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC;SACjD;KACF,CAAC,CAAC;AACL,CAAC;AAYD;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACvC,MAAyB,EACzB,eAAuC;IAEvC,OAAO,KAAK,UAAU,sBAAsB,CAC1C,OAAwD,EACxD,UAA6D;QAE7D,MAAM,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,GAAG,MAAM,CAAC,SAAS,CAAC;QAEjD,OAAO,YAAY,CAAC;YAClB,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,KAAK,CAAC;YACvD,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;gBAChC,IAAI,EAAE,GAAG,EAAE,CAAC,QAAQ,IAAI,EAAE,CAAC,KAAK,EAAE;gBAClC,EAAE,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,KAAK,CAAC;aACzC,CAAC,CAAC;YACH,KAAK,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE;YACjE,eAAe;YACf,UAAU;SACX,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,EAAoB,EACpB,OAIC;IAED,IAAI,CAAC;QACH,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,OAAO,MAAM,SAAS,CAAC,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,MAAM,EAAE,EAAE,CAAC;IACpB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACtE,OAAO,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC;QAC1B,OAAO,OAAO,CAAC,YAAY,CAAC;IAC9B,CAAC;AACH,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,4 @@
+export * from './retry';
+export * from './circuit-breaker';
+export * from './fallback';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,4 @@
+export * from './retry';
+export * from './circuit-breaker';
+export * from './fallback';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC"}