@ai-orchestration/core 0.1.0 → 0.3.0

package/dist/cjs/strategies/health-aware.js

@@ -0,0 +1,108 @@
+"use strict";
+/**
+ * Health-aware strategy: selects providers based on health metrics (latency, success rate)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HealthAwareStrategy = void 0;
+const base_js_1 = require("./base.js");
+class HealthAwareStrategy extends base_js_1.BaseStrategy {
+    constructor(config) {
+        super();
+        this.stats = new Map();
+        this.preferLowLatency = config?.preferLowLatency ?? true;
+        this.minHealthScore = config?.minHealthScore ?? 0;
+    }
+    async select(providers, context) {
+        const available = this.filterAttempted(providers, context);
+        if (available.length === 0) {
+            return null;
+        }
+        // Fetch health for all providers
+        const healthChecks = await Promise.allSettled(available.map(async (p) => {
+            const health = await p.checkHealth();
+            return { provider: p, health };
+        }));
+        // Build stats with health information
+        const candidates = [];
+        for (const result of healthChecks) {
+            if (result.status === 'fulfilled') {
+                const { provider, health } = result.value;
+                if (!health.healthy)
+                    continue;
+                const stats = this.getOrCreateStats(provider);
+                stats.health = health;
+                const healthScore = this.calculateHealthScore(stats);
+                if (healthScore >= this.minHealthScore) {
+                    candidates.push(stats);
+                }
+            }
+        }
+        if (candidates.length === 0) {
+            return null;
+        }
+        // Sort by health score (and latency if preferred)
+        candidates.sort((a, b) => {
+            const scoreA = this.calculateHealthScore(a);
+            const scoreB = this.calculateHealthScore(b);
+            if (scoreA !== scoreB) {
+                return scoreB - scoreA; // Higher score first
+            }
+            // If scores are equal and prefer low latency, sort by latency
+            if (this.preferLowLatency) {
+                const latencyA = a.health.latency ?? Infinity;
+                const latencyB = b.health.latency ?? Infinity;
+                return latencyA - latencyB;
+            }
+            return 0;
+        });
+        return candidates[0].provider;
+    }
+    update(provider, success, metadata) {
+        const stats = this.getOrCreateStats(provider);
+        if (success) {
+            stats.successCount++;
+            // Update latency if available
+            if (metadata && typeof metadata === 'object' && 'latency' in metadata) {
+                const latency = Number(metadata.latency);
+                if (!isNaN(latency)) {
+                    stats.avgLatency =
+                        stats.avgLatency === undefined
+                            ? latency
+                            : (stats.avgLatency + latency) / 2;
+                }
+            }
+        }
+        else {
+            stats.failureCount++;
+        }
+    }
+    getOrCreateStats(provider) {
+        let stats = this.stats.get(provider.id);
+        if (!stats) {
+            stats = {
+                provider,
+                health: { healthy: true },
+                successCount: 0,
+                failureCount: 0,
+            };
+            this.stats.set(provider.id, stats);
+        }
+        return stats;
+    }
+    calculateHealthScore(stats) {
+        const total = stats.successCount + stats.failureCount;
+        if (total === 0) {
+            return 1.0; // No data, assume healthy
+        }
+        const successRate = stats.successCount / total;
+        // Factor in latency if available
+        let latencyFactor = 1.0;
+        if (stats.avgLatency !== undefined) {
+            // Normalize latency (assume < 1000ms is good, > 5000ms is bad)
+            latencyFactor = Math.max(0, 1 - (stats.avgLatency - 1000) / 4000);
+        }
+        return successRate * latencyFactor;
+    }
+}
+exports.HealthAwareStrategy = HealthAwareStrategy;
+//# sourceMappingURL=health-aware.js.map

package/dist/cjs/strategies/health-aware.js.map

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

package/dist/cjs/strategies/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Export all strategies
+ */
+export { BaseStrategy } from './base.js';
+export { RoundRobinStrategy } from './round-robin.js';
+export { PriorityStrategy } from './priority.js';
+export type { PriorityStrategyConfig } from './priority.js';
+export { FallbackStrategy } from './fallback.js';
+export type { FallbackStrategyConfig } from './fallback.js';
+export { WeightedStrategy } from './weighted.js';
+export type { WeightedStrategyConfig } from './weighted.js';
+export { HealthAwareStrategy } from './health-aware.js';
+export type { HealthAwareStrategyConfig } from './health-aware.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/strategies/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/strategies/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,YAAY,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,YAAY,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,YAAY,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,YAAY,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/cjs/strategies/index.js

@@ -0,0 +1,19 @@
+"use strict";
+/**
+ * Export all strategies
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HealthAwareStrategy = exports.WeightedStrategy = exports.FallbackStrategy = exports.PriorityStrategy = exports.RoundRobinStrategy = exports.BaseStrategy = void 0;
+var base_js_1 = require("./base.js");
+Object.defineProperty(exports, "BaseStrategy", { enumerable: true, get: function () { return base_js_1.BaseStrategy; } });
+var round_robin_js_1 = require("./round-robin.js");
+Object.defineProperty(exports, "RoundRobinStrategy", { enumerable: true, get: function () { return round_robin_js_1.RoundRobinStrategy; } });
+var priority_js_1 = require("./priority.js");
+Object.defineProperty(exports, "PriorityStrategy", { enumerable: true, get: function () { return priority_js_1.PriorityStrategy; } });
+var fallback_js_1 = require("./fallback.js");
+Object.defineProperty(exports, "FallbackStrategy", { enumerable: true, get: function () { return fallback_js_1.FallbackStrategy; } });
+var weighted_js_1 = require("./weighted.js");
+Object.defineProperty(exports, "WeightedStrategy", { enumerable: true, get: function () { return weighted_js_1.WeightedStrategy; } });
+var health_aware_js_1 = require("./health-aware.js");
+Object.defineProperty(exports, "HealthAwareStrategy", { enumerable: true, get: function () { return health_aware_js_1.HealthAwareStrategy; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/strategies/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/strategies/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,qCAAyC;AAAhC,uGAAA,YAAY,OAAA;AACrB,mDAAsD;AAA7C,oHAAA,kBAAkB,OAAA;AAC3B,6CAAiD;AAAxC,+GAAA,gBAAgB,OAAA;AAEzB,6CAAiD;AAAxC,+GAAA,gBAAgB,OAAA;AAEzB,6CAAiD;AAAxC,+GAAA,gBAAgB,OAAA;AAEzB,qDAAwD;AAA/C,sHAAA,mBAAmB,OAAA"}

package/dist/cjs/strategies/priority.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Priority strategy: selects providers based on priority order
+ */
+import { BaseStrategy } from './base.js';
+import type { AIService, SelectionContext } from '../core/interfaces.js';
+export interface PriorityStrategyConfig {
+    priorities?: Record<string, number>;
+}
+export declare class PriorityStrategy extends BaseStrategy {
+    private priorities;
+    constructor(config?: PriorityStrategyConfig);
+    select(providers: AIService[], context?: SelectionContext): Promise<AIService | null>;
+    /**
+     * Set priority for a provider
+     */
+    setPriority(providerId: string, priority: number): void;
+}
+//# sourceMappingURL=priority.d.ts.map

package/dist/cjs/strategies/priority.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"priority.d.ts","sourceRoot":"","sources":["../../../src/strategies/priority.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzE,MAAM,WAAW,sBAAsB;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAED,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,OAAO,CAAC,UAAU,CAAkC;gBAExC,MAAM,CAAC,EAAE,sBAAsB;IASrC,MAAM,CACV,SAAS,EAAE,SAAS,EAAE,EACtB,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAgB5B;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;CAGxD"}

package/dist/cjs/strategies/priority.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * Priority strategy: selects providers based on priority order
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PriorityStrategy = void 0;
+const base_js_1 = require("./base.js");
+class PriorityStrategy extends base_js_1.BaseStrategy {
+    constructor(config) {
+        super();
+        this.priorities = new Map();
+        if (config?.priorities) {
+            Object.entries(config.priorities).forEach(([id, priority]) => {
+                this.priorities.set(id, priority);
+            });
+        }
+    }
+    async select(providers, context) {
+        const available = this.filterAttempted(providers, context);
+        if (available.length === 0) {
+            return null;
+        }
+        // Sort by priority (lower number = higher priority)
+        const sorted = [...available].sort((a, b) => {
+            const priorityA = this.priorities.get(a.id) ?? 999;
+            const priorityB = this.priorities.get(b.id) ?? 999;
+            return priorityA - priorityB;
+        });
+        return sorted[0];
+    }
+    /**
+     * Set priority for a provider
+     */
+    setPriority(providerId, priority) {
+        this.priorities.set(providerId, priority);
+    }
+}
+exports.PriorityStrategy = PriorityStrategy;
+//# sourceMappingURL=priority.js.map

package/dist/cjs/strategies/priority.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"priority.js","sourceRoot":"","sources":["../../../src/strategies/priority.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,uCAAyC;AAOzC,MAAa,gBAAiB,SAAQ,sBAAY;IAGhD,YAAY,MAA+B;QACzC,KAAK,EAAE,CAAC;QAHF,eAAU,GAAwB,IAAI,GAAG,EAAE,CAAC;QAIlD,IAAI,MAAM,EAAE,UAAU,EAAE,CAAC;YACvB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE;gBAC3D,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;YACpC,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CACV,SAAsB,EACtB,OAA0B;QAE1B,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC3D,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,oDAAoD;QACpD,MAAM,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC;YACnD,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC;YACnD,OAAO,SAAS,GAAG,SAAS,CAAC;QAC/B,CAAC,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,UAAkB,EAAE,QAAgB;QAC9C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC5C,CAAC;CACF;AArCD,4CAqCC"}

package/dist/cjs/strategies/round-robin.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Round-robin strategy: cycles through providers in order
+ */
+import { BaseStrategy } from './base.js';
+import type { AIService, SelectionContext } from '../core/interfaces.js';
+export declare class RoundRobinStrategy extends BaseStrategy {
+    private currentIndex;
+    select(providers: AIService[], context?: SelectionContext): Promise<AIService | null>;
+}
+//# sourceMappingURL=round-robin.d.ts.map

package/dist/cjs/strategies/round-robin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"round-robin.d.ts","sourceRoot":"","sources":["../../../src/strategies/round-robin.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzE,qBAAa,kBAAmB,SAAQ,YAAY;IAClD,OAAO,CAAC,YAAY,CAAK;IAEnB,MAAM,CACV,SAAS,EAAE,SAAS,EAAE,EACtB,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;CAgB7B"}

package/dist/cjs/strategies/round-robin.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * Round-robin strategy: cycles through providers in order
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RoundRobinStrategy = void 0;
+const base_js_1 = require("./base.js");
+class RoundRobinStrategy extends base_js_1.BaseStrategy {
+    constructor() {
+        super(...arguments);
+        this.currentIndex = 0;
+    }
+    async select(providers, context) {
+        const available = this.filterAttempted(providers, context);
+        if (available.length === 0) {
+            return null;
+        }
+        // Reset index if it's out of bounds
+        if (this.currentIndex >= available.length) {
+            this.currentIndex = 0;
+        }
+        const selected = available[this.currentIndex];
+        this.currentIndex = (this.currentIndex + 1) % available.length;
+        return selected;
+    }
+}
+exports.RoundRobinStrategy = RoundRobinStrategy;
+//# sourceMappingURL=round-robin.js.map

package/dist/cjs/strategies/round-robin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"round-robin.js","sourceRoot":"","sources":["../../../src/strategies/round-robin.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,uCAAyC;AAGzC,MAAa,kBAAmB,SAAQ,sBAAY;IAApD;;QACU,iBAAY,GAAG,CAAC,CAAC;IAqB3B,CAAC;IAnBC,KAAK,CAAC,MAAM,CACV,SAAsB,EACtB,OAA0B;QAE1B,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC3D,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,oCAAoC;QACpC,IAAI,IAAI,CAAC,YAAY,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;YAC1C,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;QACxB,CAAC;QAED,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC9C,IAAI,CAAC,YAAY,GAAG,CAAC,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC;QAE/D,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AAtBD,gDAsBC"}

package/dist/cjs/strategies/weighted.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Weighted strategy: selects providers based on weights (for load balancing or cost-aware selection)
+ */
+import { BaseStrategy } from './base.js';
+import type { AIService, SelectionContext } from '../core/interfaces.js';
+export interface WeightedStrategyConfig {
+    weights?: Record<string, number>;
+    costAware?: boolean;
+}
+export declare class WeightedStrategy extends BaseStrategy {
+    private weights;
+    private costAware;
+    constructor(config?: WeightedStrategyConfig);
+    select(providers: AIService[], context?: SelectionContext): Promise<AIService | null>;
+    /**
+     * Set weight for a provider
+     */
+    setWeight(providerId: string, weight: number): void;
+}
+//# sourceMappingURL=weighted.d.ts.map

package/dist/cjs/strategies/weighted.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"weighted.d.ts","sourceRoot":"","sources":["../../../src/strategies/weighted.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzE,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,SAAS,CAAU;gBAEf,MAAM,CAAC,EAAE,sBAAsB;IAWrC,MAAM,CACV,SAAS,EAAE,SAAS,EAAE,EACtB,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IA8C5B;;OAEG;IACH,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAGpD"}

package/dist/cjs/strategies/weighted.js

@@ -0,0 +1,61 @@
+"use strict";
+/**
+ * Weighted strategy: selects providers based on weights (for load balancing or cost-aware selection)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WeightedStrategy = void 0;
+const base_js_1 = require("./base.js");
+class WeightedStrategy extends base_js_1.BaseStrategy {
+    constructor(config) {
+        super();
+        this.weights = new Map();
+        this.costAware = config?.costAware ?? false;
+        if (config?.weights) {
+            Object.entries(config.weights).forEach(([id, weight]) => {
+                this.weights.set(id, weight);
+            });
+        }
+    }
+    async select(providers, context) {
+        const available = this.filterAttempted(providers, context);
+        if (available.length === 0) {
+            return null;
+        }
+        // Calculate effective weights
+        const weightedProviders = available.map((provider) => {
+            let weight = this.weights.get(provider.id) ?? 1.0;
+            // Adjust weight based on cost if cost-aware
+            if (this.costAware && provider.metadata.costPerToken) {
+                const avgCost = (provider.metadata.costPerToken.prompt +
+                    provider.metadata.costPerToken.completion) /
+                    2;
+                // Lower cost = higher weight (inverse relationship)
+                weight = weight / (avgCost + 0.0001); // Add small epsilon to avoid division by zero
+            }
+            return { provider, weight };
+        });
+        // Calculate total weight
+        const totalWeight = weightedProviders.reduce((sum, wp) => sum + wp.weight, 0);
+        if (totalWeight === 0) {
+            return available[0]; // Fallback to first available
+        }
+        // Select using weighted random
+        let random = Math.random() * totalWeight;
+        for (const { provider, weight } of weightedProviders) {
+            random -= weight;
+            if (random <= 0) {
+                return provider;
+            }
+        }
+        // Fallback (shouldn't reach here)
+        return available[0];
+    }
+    /**
+     * Set weight for a provider
+     */
+    setWeight(providerId, weight) {
+        this.weights.set(providerId, weight);
+    }
+}
+exports.WeightedStrategy = WeightedStrategy;
+//# sourceMappingURL=weighted.js.map

package/dist/cjs/strategies/weighted.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"weighted.js","sourceRoot":"","sources":["../../../src/strategies/weighted.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,uCAAyC;AAQzC,MAAa,gBAAiB,SAAQ,sBAAY;IAIhD,YAAY,MAA+B;QACzC,KAAK,EAAE,CAAC;QAJF,YAAO,GAAwB,IAAI,GAAG,EAAE,CAAC;QAK/C,IAAI,CAAC,SAAS,GAAG,MAAM,EAAE,SAAS,IAAI,KAAK,CAAC;QAE5C,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACpB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE;gBACtD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;YAC/B,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CACV,SAAsB,EACtB,OAA0B;QAE1B,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC3D,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,8BAA8B;QAC9B,MAAM,iBAAiB,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;YACnD,IAAI,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC;YAElD,4CAA4C;YAC5C,IAAI,IAAI,CAAC,SAAS,IAAI,QAAQ,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC;gBACrD,MAAM,OAAO,GACX,CAAC,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,MAAM;oBACpC,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,UAAU,CAAC;oBAC5C,CAAC,CAAC;gBACJ,oDAAoD;gBACpD,MAAM,GAAG,MAAM,GAAG,CAAC,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,8CAA8C;YACtF,CAAC;YAED,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAC9B,CAAC,CAAC,CAAC;QAEH,yBAAyB;QACzB,MAAM,WAAW,GAAG,iBAAiB,CAAC,MAAM,CAC1C,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,MAAM,EAC5B,CAAC,CACF,CAAC;QAEF,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,8BAA8B;QACrD,CAAC;QAED,+BAA+B;QAC/B,IAAI,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,WAAW,CAAC;QACzC,KAAK,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,iBAAiB,EAAE,CAAC;YACrD,MAAM,IAAI,MAAM,CAAC;YACjB,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;gBAChB,OAAO,QAAQ,CAAC;YAClB,CAAC;QACH,CAAC;QAED,kCAAkC;QAClC,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,UAAkB,EAAE,MAAc;QAC1C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACvC,CAAC;CACF;AAtED,4CAsEC"}

package/dist/core/interfaces.d.ts

@@ -74,6 +74,48 @@ export interface StrategyConfig {
     type: string;
     [key: string]: unknown;
 }
+/**
+ * Circuit breaker configuration
+ */
+export interface CircuitBreakerConfig {
+    /**
+     * Enable circuit breaker functionality
+     */
+    enabled?: boolean;
+    /**
+     * Number of consecutive failures before opening the circuit
+     */
+    failureThreshold?: number;
+    /**
+     * Time in milliseconds before attempting to reset the circuit
+     */
+    resetTimeout?: number;
+}
+/**
+ * Health check configuration
+ */
+export interface HealthCheckConfig {
+    /**
+     * Interval between health checks in milliseconds
+     */
+    interval?: number;
+    /**
+     * Timeout for individual health checks in milliseconds
+     */
+    timeout?: number;
+    /**
+     * Maximum consecutive failures before marking provider as unhealthy
+     */
+    maxConsecutiveFailures?: number;
+    /**
+     * Maximum latency threshold in milliseconds. Providers exceeding this will be marked unhealthy.
+     */
+    latencyThreshold?: number;
+    /**
+     * Enable periodic health checks
+     */
+    enabled?: boolean;
+}
 /**
  * Main orchestrator configuration
  */
@@ -81,7 +123,44 @@ export interface OrchestratorConfig {
     providers: ProviderConfig[];
     strategy: StrategyConfig;
     defaultOptions?: ChatOptions;
-    healthCheckInterval?: number;
+    /**
+     * Maximum number of retry attempts before giving up.
+     * Defaults to the number of providers if not specified.
+     */
+    maxRetries?: number;
+    /**
+     * Global timeout for all requests in milliseconds.
+     * Defaults to 30000 (30 seconds) if not specified.
+     */
+    requestTimeout?: number;
+    /**
+     * Delay between retries in milliseconds, or 'exponential' for exponential backoff.
+     * Defaults to 1000 (1 second) if not specified.
+     */
+    retryDelay?: number | 'exponential';
+    /**
+     * Circuit breaker configuration
+     */
+    circuitBreaker?: CircuitBreakerConfig;
+    /**
+     * Health check configuration
+     */
+    healthCheck?: HealthCheckConfig;
+    /**
+     * Enable metrics collection (default: true)
+     */
+    enableMetrics?: boolean;
+    /**
+     * Callback for metrics events
+     */
+    onMetricsEvent?: import('./metrics.js').MetricsCallback;
+    /**
+     * @deprecated Use healthCheck.enabled instead
+     */
     enableHealthChecks?: boolean;
+    /**
+     * @deprecated Use healthCheck.interval instead
+     */
+    healthCheckInterval?: number;
 }
 //# sourceMappingURL=interfaces.d.ts.map

package/dist/core/interfaces.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../src/core/interfaces.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,YAAY,EACZ,SAAS,EACT,cAAc,EACd,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,WAAW,EACX,WAAW,EACX,YAAY,EACZ,SAAS,EACT,cAAc,EACd,gBAAgB,GACjB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IAEpC;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;IAEvC;;OAEG;IACH,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAE5E;;OAEG;IACH,UAAU,CACR,QAAQ,EAAE,WAAW,EAAE,EACvB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,MAAM,CACJ,SAAS,EAAE,SAAS,EAAE,EACtB,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IAE7B;;OAEG;IACH,MAAM,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC1E;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,QAAQ,EAAE,cAAc,CAAC;IACzB,cAAc,CAAC,EAAE,WAAW,CAAC;IAC7B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B"}
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../src/core/interfaces.ts"],"names":[],"mappings":"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"}

package/dist/core/metrics.d.ts

@@ -0,0 +1,161 @@
+/**
+ * Metrics and analytics system for the AI Orchestration Framework
+ */
+import type { AIService, ChatResponse } from './interfaces.js';
+import type { ProviderHealth } from './types.js';
+/**
+ * Metrics for a single provider
+ */
+export interface ProviderMetrics {
+    providerId: string;
+    providerName: string;
+    model?: string;
+    totalRequests: number;
+    successfulRequests: number;
+    failedRequests: number;
+    totalTokens: {
+        prompt: number;
+        completion: number;
+        total: number;
+    };
+    totalCost: number;
+    averageLatency: number;
+    lastUsed?: Date;
+    lastSuccess?: Date;
+    lastFailure?: Date;
+    healthHistory: Array<{
+        timestamp: Date;
+        healthy: boolean;
+        latency?: number;
+    }>;
+}
+/**
+ * Strategy selection metrics
+ */
+export interface StrategyMetrics {
+    totalSelections: number;
+    selectionsByProvider: Map<string, number>;
+    selectionsByStrategy: Map<string, number>;
+    averageSelectionTime: number;
+}
+/**
+ * Overall orchestrator metrics
+ */
+export interface OrchestratorMetrics {
+    totalRequests: number;
+    successfulRequests: number;
+    failedRequests: number;
+    totalCost: number;
+    providerMetrics: Map<string, ProviderMetrics>;
+    strategyMetrics: StrategyMetrics;
+    averageRequestLatency: number;
+    requestsPerMinute: number;
+    errorRate: number;
+}
+/**
+ * Event types for metrics tracking
+ */
+export type MetricsEvent = {
+    type: 'provider_selected';
+    providerId: string;
+    strategy: string;
+    timestamp: Date;
+    selectionTime?: number;
+} | {
+    type: 'request_started';
+    providerId: string;
+    timestamp: Date;
+} | {
+    type: 'request_success';
+    providerId: string;
+    response: ChatResponse;
+    latency: number;
+    timestamp: Date;
+} | {
+    type: 'request_failure';
+    providerId: string;
+    error: Error;
+    latency?: number;
+    timestamp: Date;
+} | {
+    type: 'health_check';
+    providerId: string;
+    health: ProviderHealth;
+    timestamp: Date;
+};
+/**
+ * Callback function for metrics events
+ */
+export type MetricsCallback = (event: MetricsEvent) => void;
+/**
+ * Metrics collector for tracking orchestrator usage
+ */
+export declare class MetricsCollector {
+    private providerMetrics;
+    private strategyMetrics;
+    private requestHistory;
+    private callbacks;
+    private selectionTimes;
+    /**
+     * Register a callback for metrics events
+     */
+    onEvent(callback: MetricsCallback): () => void;
+    /**
+     * Emit a metrics event
+     */
+    private emit;
+    /**
+     * Record provider selection
+     */
+    recordSelection(provider: AIService, strategy: string, selectionTime?: number): void;
+    /**
+     * Record request start
+     */
+    recordRequestStart(provider: AIService): void;
+    /**
+     * Record successful request
+     */
+    recordSuccess(provider: AIService, response: ChatResponse, latency: number): void;
+    /**
+     * Record failed request
+     */
+    recordFailure(provider: AIService, error: Error, latency?: number): void;
+    /**
+     * Record health check
+     */
+    recordHealthCheck(provider: AIService, health: ProviderHealth): void;
+    /**
+     * Get or create provider metrics
+     */
+    private getOrCreateProviderMetrics;
+    /**
+     * Get metrics for a specific provider
+     */
+    getProviderMetrics(providerId: string): ProviderMetrics | undefined;
+    /**
+     * Get all provider metrics
+     */
+    getAllProviderMetrics(): Map<string, ProviderMetrics>;
+    /**
+     * Get strategy metrics
+     */
+    getStrategyMetrics(): StrategyMetrics;
+    /**
+     * Get overall orchestrator metrics
+     */
+    getOrchestratorMetrics(): OrchestratorMetrics;
+    /**
+     * Reset all metrics
+     */
+    reset(): void;
+    /**
+     * Get request history (optionally filtered)
+     */
+    getRequestHistory(options?: {
+        providerId?: string;
+        startTime?: Date;
+        endTime?: Date;
+        limit?: number;
+    }): typeof this.requestHistory;
+}
+//# sourceMappingURL=metrics.d.ts.map

package/dist/core/metrics.d.ts.map

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