@ai-orchestration/core 0.1.0

package/package/dist/core/errors.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Custom error classes for the framework
+ */
+export declare class ProviderError extends Error {
+    readonly providerId: string;
+    readonly cause?: Error | undefined;
+    constructor(message: string, providerId: string, cause?: Error | undefined);
+}
+export declare class StrategyError extends Error {
+    readonly cause?: Error | undefined;
+    constructor(message: string, cause?: Error | undefined);
+}
+export declare class OrchestratorError extends Error {
+    readonly cause?: Error | undefined;
+    constructor(message: string, cause?: Error | undefined);
+}
+export declare class ConfigurationError extends Error {
+    readonly cause?: Error | undefined;
+    constructor(message: string, cause?: Error | undefined);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,aAAc,SAAQ,KAAK;aAGpB,UAAU,EAAE,MAAM;aAClB,KAAK,CAAC,EAAE,KAAK;gBAF7B,OAAO,EAAE,MAAM,EACC,UAAU,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,KAAK,YAAA;CAKhC;AAED,qBAAa,aAAc,SAAQ,KAAK;aACO,KAAK,CAAC,EAAE,KAAK;gBAA9C,OAAO,EAAE,MAAM,EAAkB,KAAK,CAAC,EAAE,KAAK,YAAA;CAI3D;AAED,qBAAa,iBAAkB,SAAQ,KAAK;aACG,KAAK,CAAC,EAAE,KAAK;gBAA9C,OAAO,EAAE,MAAM,EAAkB,KAAK,CAAC,EAAE,KAAK,YAAA;CAI3D;AAED,qBAAa,kBAAmB,SAAQ,KAAK;aACE,KAAK,CAAC,EAAE,KAAK;gBAA9C,OAAO,EAAE,MAAM,EAAkB,KAAK,CAAC,EAAE,KAAK,YAAA;CAI3D"}

package/package/dist/core/errors.js

@@ -0,0 +1,38 @@
+/**
+ * Custom error classes for the framework
+ */
+export class ProviderError extends Error {
+    providerId;
+    cause;
+    constructor(message, providerId, cause) {
+        super(message);
+        this.providerId = providerId;
+        this.cause = cause;
+        this.name = 'ProviderError';
+    }
+}
+export class StrategyError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = 'StrategyError';
+    }
+}
+export class OrchestratorError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = 'OrchestratorError';
+    }
+}
+export class ConfigurationError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = 'ConfigurationError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,OAAO,aAAc,SAAQ,KAAK;IAGpB;IACA;IAHlB,YACE,OAAe,EACC,UAAkB,EAClB,KAAa;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,eAAU,GAAV,UAAU,CAAQ;QAClB,UAAK,GAAL,KAAK,CAAQ;QAG7B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,KAAK;IACO;IAA7C,YAAY,OAAe,EAAkB,KAAa;QACxD,KAAK,CAAC,OAAO,CAAC,CAAC;QAD4B,UAAK,GAAL,KAAK,CAAQ;QAExD,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACG;IAA7C,YAAY,OAAe,EAAkB,KAAa;QACxD,KAAK,CAAC,OAAO,CAAC,CAAC;QAD4B,UAAK,GAAL,KAAK,CAAQ;QAExD,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IACE;IAA7C,YAAY,OAAe,EAAkB,KAAa;QACxD,KAAK,CAAC,OAAO,CAAC,CAAC;QAD4B,UAAK,GAAL,KAAK,CAAQ;QAExD,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF"}

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

@@ -0,0 +1,87 @@
+/**
+ * Core interfaces for AI providers and strategies
+ */
+import type { ChatMessage, ChatOptions, ChatResponse, ChatChunk, ProviderHealth, ProviderMetadata } from './types.js';
+export type { ChatMessage, ChatOptions, ChatResponse, ChatChunk, ProviderHealth, ProviderMetadata, };
+/**
+ * Main interface that all AI providers must implement
+ */
+export interface AIService {
+    /**
+     * Unique identifier for this provider instance
+     */
+    readonly id: string;
+    /**
+     * Provider metadata
+     */
+    readonly metadata: ProviderMetadata;
+    /**
+     * Check the health status of this provider
+     */
+    checkHealth(): Promise<ProviderHealth>;
+    /**
+     * Perform a chat completion (non-streaming)
+     */
+    chat(messages: ChatMessage[], options?: ChatOptions): Promise<ChatResponse>;
+    /**
+     * Perform a chat completion with streaming
+     */
+    chatStream(messages: ChatMessage[], options?: ChatOptions): Promise<ReadableStream<ChatChunk>>;
+}
+/**
+ * Strategy interface for selecting providers
+ */
+export interface SelectionStrategy {
+    /**
+     * Select a provider from the available list
+     * @param providers List of available providers
+     * @param context Optional context for selection (e.g., request metadata)
+     */
+    select(providers: AIService[], context?: SelectionContext): Promise<AIService | null>;
+    /**
+     * Update strategy state (e.g., after a successful/failed request)
+     */
+    update?(provider: AIService, success: boolean, metadata?: unknown): void;
+}
+/**
+ * Context passed to selection strategies
+ */
+export interface SelectionContext {
+    messages?: ChatMessage[];
+    options?: ChatOptions;
+    previousAttempts?: string[];
+    [key: string]: unknown;
+}
+/**
+ * Configuration for a provider instance
+ */
+export interface ProviderConfig {
+    id: string;
+    type: string;
+    apiKey?: string;
+    baseURL?: string;
+    model?: string;
+    enabled?: boolean;
+    priority?: number;
+    weight?: number;
+    metadata?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+/**
+ * Configuration for a selection strategy
+ */
+export interface StrategyConfig {
+    type: string;
+    [key: string]: unknown;
+}
+/**
+ * Main orchestrator configuration
+ */
+export interface OrchestratorConfig {
+    providers: ProviderConfig[];
+    strategy: StrategyConfig;
+    defaultOptions?: ChatOptions;
+    healthCheckInterval?: number;
+    enableHealthChecks?: boolean;
+}
+//# sourceMappingURL=interfaces.d.ts.map

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

@@ -0,0 +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"}

package/package/dist/core/interfaces.js

@@ -0,0 +1,5 @@
+/**
+ * Core interfaces for AI providers and strategies
+ */
+export {};
+//# sourceMappingURL=interfaces.js.map

package/package/dist/core/interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../src/core/interfaces.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/package/dist/core/orchestrator.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Core orchestrator that manages providers and strategies
+ */
+import type { AIService, SelectionStrategy, SelectionContext, ChatMessage, ChatOptions, ChatResponse, ChatChunk } from './interfaces.js';
+export declare class Orchestrator {
+    private providers;
+    private strategy;
+    private healthCheckInterval?;
+    constructor(strategy: SelectionStrategy);
+    /**
+     * Register a provider
+     */
+    registerProvider(provider: AIService): void;
+    /**
+     * Unregister a provider
+     */
+    unregisterProvider(id: string): void;
+    /**
+     * Get a provider by ID
+     */
+    getProvider(id: string): AIService | undefined;
+    /**
+     * Get all registered providers
+     */
+    getAllProviders(): AIService[];
+    /**
+     * Get enabled providers (those that pass basic checks)
+     */
+    getAvailableProviders(): Promise<AIService[]>;
+    /**
+     * Select a provider using the configured strategy
+     */
+    selectProvider(context?: SelectionContext): Promise<AIService | null>;
+    /**
+     * Perform a chat completion with automatic provider selection and fallback
+     */
+    chat(messages: ChatMessage[], options?: ChatOptions): Promise<ChatResponse>;
+    /**
+     * Perform a streaming chat completion with automatic provider selection
+     */
+    chatStream(messages: ChatMessage[], options?: ChatOptions): Promise<ReadableStream<ChatChunk>>;
+    /**
+     * Start periodic health checks
+     */
+    startHealthChecks(intervalMs: number): void;
+    /**
+     * Stop periodic health checks
+     */
+    stopHealthChecks(): void;
+    /**
+     * Cleanup resources
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=orchestrator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/core/orchestrator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,YAAY,EACZ,SAAS,EACV,MAAM,iBAAiB,CAAC;AAEzB,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAqC;IACtD,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,mBAAmB,CAAC,CAAiC;gBAEjD,QAAQ,EAAE,iBAAiB;IAIvC;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,SAAS,GAAG,IAAI;IAI3C;;OAEG;IACH,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIpC;;OAEG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAI9C;;OAEG;IACH,eAAe,IAAI,SAAS,EAAE;IAI9B;;OAEG;IACG,qBAAqB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAkBnD;;OAEG;IACG,cAAc,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAQ3E;;OAEG;IACG,IAAI,CACR,QAAQ,EAAE,WAAW,EAAE,EACvB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,YAAY,CAAC;IAsCxB;;OAEG;IACG,UAAU,CACd,QAAQ,EAAE,WAAW,EAAE,EACvB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;IAyBrC;;OAEG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAU3C;;OAEG;IACH,gBAAgB,IAAI,IAAI;IAOxB;;OAEG;IACH,OAAO,IAAI,IAAI;CAIhB"}

package/package/dist/core/orchestrator.js

@@ -0,0 +1,147 @@
+/**
+ * Core orchestrator that manages providers and strategies
+ */
+export class Orchestrator {
+    providers = new Map();
+    strategy;
+    healthCheckInterval;
+    constructor(strategy) {
+        this.strategy = strategy;
+    }
+    /**
+     * Register a provider
+     */
+    registerProvider(provider) {
+        this.providers.set(provider.id, provider);
+    }
+    /**
+     * Unregister a provider
+     */
+    unregisterProvider(id) {
+        this.providers.delete(id);
+    }
+    /**
+     * Get a provider by ID
+     */
+    getProvider(id) {
+        return this.providers.get(id);
+    }
+    /**
+     * Get all registered providers
+     */
+    getAllProviders() {
+        return Array.from(this.providers.values());
+    }
+    /**
+     * Get enabled providers (those that pass basic checks)
+     */
+    async getAvailableProviders() {
+        const providers = this.getAllProviders();
+        const available = [];
+        for (const provider of providers) {
+            try {
+                const health = await provider.checkHealth();
+                if (health.healthy) {
+                    available.push(provider);
+                }
+            }
+            catch {
+                // Skip unhealthy providers
+            }
+        }
+        return available;
+    }
+    /**
+     * Select a provider using the configured strategy
+     */
+    async selectProvider(context) {
+        const available = await this.getAvailableProviders();
+        if (available.length === 0) {
+            return null;
+        }
+        return this.strategy.select(available, context);
+    }
+    /**
+     * Perform a chat completion with automatic provider selection and fallback
+     */
+    async chat(messages, options) {
+        const context = {
+            messages,
+            options,
+            previousAttempts: [],
+        };
+        const maxAttempts = this.providers.size || 1;
+        let lastError = null;
+        for (let attempt = 0; attempt < maxAttempts; attempt++) {
+            const provider = await this.selectProvider(context);
+            if (!provider) {
+                throw new Error('No available providers. All providers are unhealthy or unavailable.');
+            }
+            // Skip providers we've already tried
+            if (context.previousAttempts?.includes(provider.id)) {
+                continue;
+            }
+            try {
+                const response = await provider.chat(messages, options);
+                this.strategy.update?.(provider, true, { response });
+                return response;
+            }
+            catch (error) {
+                lastError = error instanceof Error ? error : new Error(String(error));
+                context.previousAttempts?.push(provider.id);
+                this.strategy.update?.(provider, false, { error });
+            }
+        }
+        throw lastError || new Error('Failed to get response from any provider');
+    }
+    /**
+     * Perform a streaming chat completion with automatic provider selection
+     */
+    async chatStream(messages, options) {
+        const context = {
+            messages,
+            options: { ...options, stream: true },
+            previousAttempts: [],
+        };
+        const provider = await this.selectProvider(context);
+        if (!provider) {
+            throw new Error('No available providers. All providers are unhealthy or unavailable.');
+        }
+        try {
+            const stream = await provider.chatStream(messages, options);
+            this.strategy.update?.(provider, true);
+            return stream;
+        }
+        catch (error) {
+            this.strategy.update?.(provider, false, { error });
+            throw error;
+        }
+    }
+    /**
+     * Start periodic health checks
+     */
+    startHealthChecks(intervalMs) {
+        this.stopHealthChecks();
+        this.healthCheckInterval = setInterval(async () => {
+            const providers = this.getAllProviders();
+            await Promise.allSettled(providers.map((p) => p.checkHealth().catch(() => null)));
+        }, intervalMs);
+    }
+    /**
+     * Stop periodic health checks
+     */
+    stopHealthChecks() {
+        if (this.healthCheckInterval) {
+            clearInterval(this.healthCheckInterval);
+            this.healthCheckInterval = undefined;
+        }
+    }
+    /**
+     * Cleanup resources
+     */
+    dispose() {
+        this.stopHealthChecks();
+        this.providers.clear();
+    }
+}
+//# sourceMappingURL=orchestrator.js.map

package/package/dist/core/orchestrator.js.map

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

package/package/dist/core/types.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Core types and interfaces for the AI Orchestration Framework
+ */
+/**
+ * Represents a chat message in a conversation
+ */
+export interface ChatMessage {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+/**
+ * Options for chat completion requests
+ */
+export interface ChatOptions {
+    temperature?: number;
+    maxTokens?: number;
+    topP?: number;
+    topK?: number;
+    stream?: boolean;
+    stopSequences?: string[];
+    [key: string]: unknown;
+}
+/**
+ * Response from a chat completion (non-streaming)
+ */
+export interface ChatResponse {
+    content: string;
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+    model?: string;
+    finishReason?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Streaming chunk from a chat completion
+ */
+export interface ChatChunk {
+    content: string;
+    done: boolean;
+    usage?: {
+        promptTokens?: number;
+        completionTokens?: number;
+        totalTokens?: number;
+    };
+    finishReason?: string;
+}
+/**
+ * Health status of a provider
+ */
+export interface ProviderHealth {
+    healthy: boolean;
+    latency?: number;
+    lastChecked?: Date;
+    error?: string;
+}
+/**
+ * Provider metadata
+ */
+export interface ProviderMetadata {
+    id: string;
+    name: string;
+    model?: string;
+    costPerToken?: {
+        prompt: number;
+        completion: number;
+    };
+    capabilities?: string[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE;QACN,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE;QACN,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE;QACb,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB"}

package/package/dist/core/types.js

@@ -0,0 +1,5 @@
+/**
+ * Core types and interfaces for the AI Orchestration Framework
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/package/dist/factory/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Factory for creating orchestrators from configuration
+ */
+import { Orchestrator } from '../core/orchestrator.js';
+import type { OrchestratorConfig } from '../core/interfaces.js';
+/**
+ * Create an orchestrator from configuration
+ */
+export declare function createOrchestrator(config: OrchestratorConfig): Orchestrator;
+/**
+ * Type guard to check if a config is valid
+ */
+export declare function isValidOrchestratorConfig(config: unknown): config is OrchestratorConfig;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/factory/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,KAAK,EACV,kBAAkB,EAKnB,MAAM,uBAAuB,CAAC;AAyK/B;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY,CAkD3E;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,OAAO,GACd,MAAM,IAAI,kBAAkB,CAqB9B"}

package/package/dist/factory/index.js

@@ -0,0 +1,184 @@
+/**
+ * Factory for creating orchestrators from configuration
+ */
+import { Orchestrator } from '../core/orchestrator.js';
+import { ConfigurationError, ProviderError } from '../core/errors.js';
+import { RoundRobinStrategy, PriorityStrategy, FallbackStrategy, WeightedStrategy, HealthAwareStrategy, } from '../strategies/index.js';
+import { GroqProvider, OpenRouterProvider, GeminiProvider, CerebrasProvider, LocalProvider, } from '../providers/index.js';
+/**
+ * Create a provider instance from configuration
+ */
+function createProvider(config) {
+    const { type, id, enabled = true, apiKey, baseURL, model, ...rest } = config;
+    if (!id || typeof id !== 'string') {
+        throw new ConfigurationError(`Provider must have a valid id`);
+    }
+    if (!type || typeof type !== 'string') {
+        throw new ConfigurationError(`Provider ${id} must have a type`);
+    }
+    if (!enabled) {
+        throw new ConfigurationError(`Provider ${id} is disabled`);
+    }
+    try {
+        switch (type.toLowerCase()) {
+            case 'groq':
+                if (!apiKey) {
+                    throw new ConfigurationError(`Provider ${id} (groq) requires apiKey`);
+                }
+                return new GroqProvider({
+                    id,
+                    apiKey,
+                    model,
+                    baseURL,
+                    ...rest,
+                });
+            case 'openrouter':
+                if (!apiKey) {
+                    throw new ConfigurationError(`Provider ${id} (openrouter) requires apiKey`);
+                }
+                return new OpenRouterProvider({
+                    id,
+                    apiKey,
+                    model,
+                    baseURL,
+                    ...rest,
+                });
+            case 'gemini':
+                if (!apiKey) {
+                    throw new ConfigurationError(`Provider ${id} (gemini) requires apiKey`);
+                }
+                return new GeminiProvider({
+                    id,
+                    apiKey,
+                    model,
+                    baseURL,
+                    ...rest,
+                });
+            case 'cerebras':
+                if (!apiKey) {
+                    throw new ConfigurationError(`Provider ${id} (cerebras) requires apiKey`);
+                }
+                return new CerebrasProvider({
+                    id,
+                    apiKey,
+                    model,
+                    baseURL,
+                    ...rest,
+                });
+            case 'local':
+                if (!baseURL) {
+                    throw new ConfigurationError(`Provider ${id} (local) requires baseURL`);
+                }
+                return new LocalProvider({
+                    id,
+                    baseURL,
+                    model,
+                    apiKey,
+                    ...rest,
+                });
+            default:
+                throw new ConfigurationError(`Unknown provider type: ${type}`);
+        }
+    }
+    catch (error) {
+        if (error instanceof ConfigurationError) {
+            throw error;
+        }
+        throw new ProviderError(`Failed to create provider ${id}`, id, error instanceof Error ? error : new Error(String(error)));
+    }
+}
+/**
+ * Create a strategy instance from configuration
+ */
+function createStrategy(config) {
+    const { type, ...rest } = config;
+    if (!type || typeof type !== 'string') {
+        throw new ConfigurationError('Strategy must have a type');
+    }
+    try {
+        switch (type.toLowerCase()) {
+            case 'round-robin':
+            case 'roundrobin':
+                return new RoundRobinStrategy();
+            case 'priority':
+                return new PriorityStrategy(rest);
+            case 'fallback':
+                return new FallbackStrategy(rest);
+            case 'weighted':
+                return new WeightedStrategy(rest);
+            case 'health-aware':
+            case 'healthaware':
+                return new HealthAwareStrategy(rest);
+            default:
+                throw new ConfigurationError(`Unknown strategy type: ${type}`);
+        }
+    }
+    catch (error) {
+        if (error instanceof ConfigurationError) {
+            throw error;
+        }
+        throw new ConfigurationError(`Failed to create strategy: ${error instanceof Error ? error.message : String(error)}`, error instanceof Error ? error : undefined);
+    }
+}
+/**
+ * Create an orchestrator from configuration
+ */
+export function createOrchestrator(config) {
+    // Validate configuration
+    if (!isValidOrchestratorConfig(config)) {
+        throw new ConfigurationError('Invalid orchestrator configuration');
+    }
+    if (config.providers.length === 0) {
+        throw new ConfigurationError('At least one provider is required');
+    }
+    // Create strategy
+    const strategy = createStrategy(config.strategy);
+    // Create orchestrator
+    const orchestrator = new Orchestrator(strategy);
+    // Register providers
+    const registeredProviders = [];
+    for (const providerConfig of config.providers) {
+        if (providerConfig.enabled !== false) {
+            try {
+                const provider = createProvider(providerConfig);
+                orchestrator.registerProvider(provider);
+                registeredProviders.push(providerConfig.id);
+            }
+            catch (error) {
+                console.warn(`Failed to create provider ${providerConfig.id}:`, error instanceof Error ? error.message : String(error));
+            }
+        }
+    }
+    if (registeredProviders.length === 0) {
+        throw new ConfigurationError('No providers could be created. Check your configuration.');
+    }
+    // Start health checks if enabled
+    if (config.enableHealthChecks && config.healthCheckInterval) {
+        if (config.healthCheckInterval < 1000) {
+            console.warn('Health check interval is very low (< 1000ms). Consider using at least 1000ms.');
+        }
+        orchestrator.startHealthChecks(config.healthCheckInterval);
+    }
+    return orchestrator;
+}
+/**
+ * Type guard to check if a config is valid
+ */
+export function isValidOrchestratorConfig(config) {
+    if (!config || typeof config !== 'object') {
+        return false;
+    }
+    const c = config;
+    if (!Array.isArray(c.providers) || c.providers.length === 0) {
+        return false;
+    }
+    if (!c.strategy || typeof c.strategy !== 'object') {
+        return false;
+    }
+    const strategy = c.strategy;
+    if (typeof strategy.type !== 'string') {
+        return false;
+    }
+    return true;
+}
+//# sourceMappingURL=index.js.map