erosolar-cli 1.7.439 → 1.7.441

package/dist/providers/openaiResponsesProvider.js

@@ -0,0 +1,364 @@
+import OpenAI from 'openai';
+// ============================================================================
+// Error Recovery Constants
+// ============================================================================
+const RECOVERABLE_ERROR_PATTERNS = [
+    'premature close',
+    'premature end',
+    'unexpected end',
+    'aborted',
+    'fetcherror',
+    'invalid response body',
+    'gunzip',
+    'decompress',
+    'econnreset',
+    'econnrefused',
+    'epipe',
+    'socket hang up',
+    'network',
+    'timeout',
+    'rate limit',
+    '429',
+    '500',
+    '502',
+    '503',
+    '504',
+];
+function isRecoverableError(error) {
+    if (!(error instanceof Error))
+        return false;
+    const message = error.message.toLowerCase();
+    const errorName = error.name?.toLowerCase() ?? '';
+    const errorCode = error.code?.toLowerCase() ?? '';
+    const allText = `${message} ${errorName} ${errorCode}`;
+    return RECOVERABLE_ERROR_PATTERNS.some(pattern => allText.includes(pattern));
+}
+/**
+ * Check if a model supports reasoning parameters.
+ * Only GPT-5.x models support the reasoning effort parameter.
+ */
+function supportsReasoningParam(model) {
+    const lowerModel = model.toLowerCase();
+    // Only GPT-5 and GPT-5.1 models support reasoning parameters
+    return lowerModel.includes('gpt-5');
+}
+export class OpenAIResponsesProvider {
+    id;
+    model;
+    client;
+    reasoningEffort;
+    textVerbosity;
+    maxRetries;
+    constructor(options) {
+        const clientConfig = {
+            apiKey: options.apiKey,
+            timeout: options.timeout ?? 120000,
+            maxRetries: 0, // We handle retries ourselves
+        };
+        if (options.baseURL) {
+            clientConfig.baseURL = options.baseURL;
+        }
+        this.client = new OpenAI(clientConfig);
+        this.id = options.providerId ?? 'openai';
+        this.model = options.model;
+        // Only set reasoningEffort for models that support it
+        this.reasoningEffort = supportsReasoningParam(options.model) ? options.reasoningEffort : undefined;
+        this.textVerbosity = options.textVerbosity;
+        this.maxRetries = options.maxRetries ?? 3;
+    }
+    /**
+     * Sleep for a given number of milliseconds
+     */
+    sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+    /**
+     * Calculate exponential backoff delay with jitter
+     */
+    getBackoffDelay(attempt, baseDelay = 1000, maxDelay = 30000) {
+        const delay = Math.min(baseDelay * Math.pow(2, attempt), maxDelay);
+        return delay + Math.random() * delay * 0.1;
+    }
+    /**
+     * Execute request with retry logic for transient errors
+     */
+    async executeWithRetry(operation, operationName) {
+        let lastError;
+        for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+            try {
+                return await operation();
+            }
+            catch (error) {
+                lastError = error instanceof Error ? error : new Error(String(error));
+                if (isRecoverableError(error) && attempt < this.maxRetries) {
+                    const delay = this.getBackoffDelay(attempt);
+                    console.warn(`[${this.id}] ${operationName} failed (attempt ${attempt + 1}/${this.maxRetries + 1}): ` +
+                        `${lastError.message}. Retrying in ${Math.round(delay)}ms...`);
+                    await this.sleep(delay);
+                    continue;
+                }
+                throw error;
+            }
+        }
+        throw lastError;
+    }
+    async generate(messages, tools) {
+        return this.executeWithRetry(async () => {
+            const request = {
+                model: this.model,
+                input: mapMessages(messages),
+                tools: tools.length ? tools.map(mapTool) : undefined,
+                // Enable parallel tool calls for better efficiency
+                parallel_tool_calls: tools.length ? true : undefined,
+                stream: false,
+            };
+            if (this.reasoningEffort) {
+                request.reasoning = { effort: this.reasoningEffort };
+            }
+            if (this.textVerbosity) {
+                request.text = { verbosity: this.textVerbosity };
+            }
+            const response = await this.client.responses.create(request);
+            assertHasOutput(response);
+            // Safely extract tool calls with error recovery
+            let toolCalls = [];
+            try {
+                toolCalls = response.output.filter(isFunctionCall).map(mapToolCall);
+            }
+            catch (parseError) {
+                console.warn(`[${this.id}] Failed to parse tool calls, recovering: ` +
+                    `${parseError instanceof Error ? parseError.message : String(parseError)}`);
+            }
+            const usage = mapUsage(response.usage);
+            if (toolCalls.length > 0) {
+                return {
+                    type: 'tool_calls',
+                    toolCalls,
+                    content: extractTextContent(response),
+                    usage,
+                };
+            }
+            return {
+                type: 'message',
+                content: extractTextContent(response),
+                usage,
+            };
+        }, 'generate');
+    }
+    async *generateStream(messages, tools) {
+        const request = {
+            model: this.model,
+            input: mapMessages(messages),
+            tools: tools.length ? tools.map(mapTool) : undefined,
+            // Enable parallel tool calls for better efficiency
+            parallel_tool_calls: tools.length ? true : undefined,
+            stream: true,
+        };
+        if (this.reasoningEffort) {
+            request.reasoning = { effort: this.reasoningEffort };
+        }
+        if (this.textVerbosity) {
+            request.text = { verbosity: this.textVerbosity };
+        }
+        const stream = await this.client.responses.create(request);
+        // Track function calls by item_id -> { call_id, name, arguments }
+        const functionCallsById = new Map();
+        for await (const event of stream) {
+            switch (event.type) {
+                case 'response.output_text.delta':
+                    if (event.delta) {
+                        yield { type: 'content', content: event.delta };
+                    }
+                    break;
+                // Capture function call metadata when it's added
+                case 'response.output_item.added': {
+                    const item = event.item;
+                    if (item?.type === 'function_call' && item.id) {
+                        functionCallsById.set(item.id, {
+                            callId: item.call_id ?? item.id,
+                            name: item.name ?? '',
+                            arguments: '',
+                        });
+                    }
+                    break;
+                }
+                case 'response.function_call_arguments.delta': {
+                    const itemId = event.item_id;
+                    if (itemId) {
+                        const existing = functionCallsById.get(itemId);
+                        if (existing) {
+                            existing.arguments += event.delta ?? '';
+                        }
+                    }
+                    break;
+                }
+                case 'response.function_call_arguments.done': {
+                    const itemId = event.item_id;
+                    if (itemId) {
+                        const pending = functionCallsById.get(itemId);
+                        if (pending) {
+                            let parsed = {};
+                            try {
+                                parsed = JSON.parse(pending.arguments || '{}');
+                            }
+                            catch {
+                                parsed = {};
+                            }
+                            yield {
+                                type: 'tool_call',
+                                toolCall: {
+                                    id: pending.callId,
+                                    name: pending.name,
+                                    arguments: parsed,
+                                },
+                            };
+                            functionCallsById.delete(itemId);
+                        }
+                    }
+                    break;
+                }
+                case 'response.done':
+                case 'response.completed':
+                    if (event.response?.usage) {
+                        const usage = mapUsage(event.response.usage);
+                        if (usage) {
+                            yield { type: 'usage', usage };
+                        }
+                    }
+                    yield { type: 'done' };
+                    break;
+            }
+        }
+    }
+}
+function mapMessages(messages) {
+    const input = [];
+    for (const message of messages) {
+        switch (message.role) {
+            case 'system':
+            case 'user':
+            case 'assistant': {
+                input.push({
+                    role: message.role,
+                    content: message.content,
+                    type: 'message',
+                });
+                if (message.role === 'assistant') {
+                    for (const call of message.toolCalls ?? []) {
+                        input.push({
+                            type: 'function_call',
+                            call_id: call.id,
+                            name: call.name,
+                            arguments: JSON.stringify(call.arguments ?? {}),
+                        });
+                    }
+                }
+                break;
+            }
+            case 'tool': {
+                input.push({
+                    type: 'function_call_output',
+                    call_id: message.toolCallId,
+                    output: message.content,
+                });
+                break;
+            }
+            default:
+                break;
+        }
+    }
+    return input;
+}
+function mapTool(definition) {
+    return {
+        type: 'function',
+        name: definition.name,
+        description: definition.description,
+        parameters: (definition.parameters ?? {
+            type: 'object',
+            properties: {},
+        }),
+        strict: false,
+    };
+}
+function extractTextContent(response) {
+    const primary = collectOutputText(response.output);
+    if (primary) {
+        return primary;
+    }
+    const aggregated = typeof response.output_text === 'string' ? response.output_text.trim() : '';
+    if (aggregated) {
+        return aggregated;
+    }
+    const refusal = collectRefusalText(response.output);
+    if (refusal) {
+        return refusal;
+    }
+    return '';
+}
+function collectOutputText(output) {
+    const chunks = [];
+    for (const item of output) {
+        if (!isOutputMessage(item)) {
+            continue;
+        }
+        for (const block of item.content) {
+            if (block.type === 'output_text') {
+                chunks.push(block.text);
+            }
+        }
+    }
+    return chunks.join('\n').trim();
+}
+function collectRefusalText(output) {
+    for (const item of output) {
+        if (!isOutputMessage(item)) {
+            continue;
+        }
+        for (const block of item.content) {
+            if (isRefusal(block) && block.refusal?.trim()) {
+                return block.refusal.trim();
+            }
+        }
+    }
+    return '';
+}
+function mapToolCall(call) {
+    let parsed = {};
+    try {
+        parsed = JSON.parse(call.arguments ?? '{}');
+    }
+    catch {
+        parsed = {};
+    }
+    return {
+        id: call.call_id ?? call.id ?? '',
+        name: call.name,
+        arguments: parsed,
+    };
+}
+function mapUsage(usage) {
+    if (!usage) {
+        return undefined;
+    }
+    return {
+        inputTokens: usage.input_tokens,
+        outputTokens: usage.output_tokens,
+        totalTokens: usage.total_tokens,
+    };
+}
+function isFunctionCall(item) {
+    return item.type === 'function_call';
+}
+function isOutputMessage(item) {
+    return item.type === 'message';
+}
+function isRefusal(block) {
+    return block.type === 'refusal';
+}
+function assertHasOutput(response) {
+    if (!('output' in response)) {
+        throw new Error('Streaming responses are not supported in this runtime.');
+    }
+}
+//# sourceMappingURL=openaiResponsesProvider.js.map

package/dist/providers/openaiResponsesProvider.js.map

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

package/dist/providers/providerFactory.d.ts

@@ -0,0 +1,18 @@
+import type { LLMProvider, ProviderId, ReasoningEffortLevel, TextVerbosityLevel } from '../core/types.js';
+export interface ProviderConfig {
+    provider: ProviderId;
+    model: string;
+    temperature?: number;
+    maxTokens?: number;
+    reasoningEffort?: ReasoningEffortLevel;
+    textVerbosity?: TextVerbosityLevel;
+}
+export type ProviderFactory = (config: ProviderConfig) => LLMProvider;
+export interface RegisterProviderOptions {
+    override?: boolean;
+}
+export declare function registerProvider(id: ProviderId, factory: ProviderFactory, options?: RegisterProviderOptions): void;
+export declare function createProvider(config: ProviderConfig): LLMProvider;
+export declare function listRegisteredProviders(): ProviderId[];
+export declare function hasProvider(id: ProviderId): boolean;
+//# sourceMappingURL=providerFactory.d.ts.map

package/dist/providers/providerFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providerFactory.d.ts","sourceRoot":"","sources":["../../src/providers/providerFactory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,UAAU,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,oBAAoB,CAAC;IACvC,aAAa,CAAC,EAAE,kBAAkB,CAAC;CACpC;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,cAAc,KAAK,WAAW,CAAC;AAEtE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAID,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,eAAe,EAAE,OAAO,GAAE,uBAA4B,GAAG,IAAI,CAQtH;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,WAAW,CAOlE;AAED,wBAAgB,uBAAuB,IAAI,UAAU,EAAE,CAEtD;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,UAAU,GAAG,OAAO,CAEnD"}

package/dist/providers/providerFactory.js

@@ -0,0 +1,25 @@
+const registry = new Map();
+export function registerProvider(id, factory, options = {}) {
+    if (!id?.trim()) {
+        throw new Error('Provider id cannot be blank.');
+    }
+    if (registry.has(id) && !options.override) {
+        throw new Error(`Provider "${id}" is already registered.`);
+    }
+    registry.set(id, factory);
+}
+export function createProvider(config) {
+    const factory = registry.get(config.provider);
+    if (!factory) {
+        const known = Array.from(registry.keys()).sort().join(', ');
+        throw new Error(`Provider "${config.provider}" is not registered. Registered providers: ${known || 'none'}.`);
+    }
+    return factory(config);
+}
+export function listRegisteredProviders() {
+    return Array.from(registry.keys());
+}
+export function hasProvider(id) {
+    return registry.has(id);
+}
+//# sourceMappingURL=providerFactory.js.map

package/dist/providers/providerFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providerFactory.js","sourceRoot":"","sources":["../../src/providers/providerFactory.ts"],"names":[],"mappings":"AAsBA,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA+B,CAAC;AAExD,MAAM,UAAU,gBAAgB,CAAC,EAAc,EAAE,OAAwB,EAAE,UAAmC,EAAE;IAC9G,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAClD,CAAC;IACD,IAAI,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,aAAa,EAAE,0BAA0B,CAAC,CAAC;IAC7D,CAAC;IACD,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAsB;IACnD,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC9C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5D,MAAM,IAAI,KAAK,CAAC,aAAa,MAAM,CAAC,QAAQ,8CAA8C,KAAK,IAAI,MAAM,GAAG,CAAC,CAAC;IAChH,CAAC;IACD,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,EAAc;IACxC,OAAO,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAC1B,CAAC"}

package/dist/providers/resilientProvider.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Resilient Provider Wrapper
+ *
+ * Adds rate limiting, exponential backoff retry, and circuit breaker
+ * patterns to any LLM provider for maximum reliability and performance.
+ *
+ * PERF: Provider-agnostic wrapper that prevents rate limit errors and
+ * automatically recovers from transient failures.
+ */
+import type { LLMProvider, ConversationMessage, ProviderToolDefinition, ProviderResponse, StreamChunk, ProviderId } from '../core/types.js';
+export interface ResilientProviderConfig {
+    /** Maximum requests per window (default: 50) */
+    maxRequestsPerMinute?: number;
+    /** Maximum retry attempts (default: 4) */
+    maxRetries?: number;
+    /** Base delay for exponential backoff in ms (default: 1000) */
+    baseDelayMs?: number;
+    /** Maximum delay between retries in ms (default: 32000) */
+    maxDelayMs?: number;
+    /** Enable circuit breaker pattern (default: true) */
+    enableCircuitBreaker?: boolean;
+    /** Number of failures before circuit opens (default: 5) */
+    circuitBreakerThreshold?: number;
+    /** Time before circuit resets in ms (default: 60000) */
+    circuitBreakerResetMs?: number;
+}
+/**
+ * Wraps any LLM provider with rate limiting and retry logic
+ */
+export declare class ResilientProvider implements LLMProvider {
+    readonly id: ProviderId;
+    readonly model: string;
+    private readonly provider;
+    private readonly rateLimiter;
+    private readonly config;
+    private readonly circuitBreaker;
+    private stats;
+    constructor(provider: LLMProvider, config?: ResilientProviderConfig);
+    /**
+     * Check and potentially reset circuit breaker
+     */
+    private checkCircuitBreaker;
+    /**
+     * Record a failure for circuit breaker
+     */
+    private recordFailure;
+    /**
+     * Record a success to reset circuit breaker
+     */
+    private recordSuccess;
+    /**
+     * Execute a request with rate limiting and retry
+     */
+    private executeWithResilience;
+    /**
+     * Generate a response with resilience
+     */
+    generate(messages: ConversationMessage[], tools: ProviderToolDefinition[]): Promise<ProviderResponse>;
+    /**
+     * Generate a streaming response with resilience
+     *
+     * Note: Retry logic is limited for streaming - we can only retry
+     * before the stream starts, not mid-stream.
+     */
+    generateStream(messages: ConversationMessage[], tools: ProviderToolDefinition[]): AsyncIterableIterator<StreamChunk>;
+    /**
+     * Get resilience statistics
+     */
+    getStats(): {
+        totalRequests: number;
+        rateLimitHits: number;
+        retries: number;
+        circuitBreakerTrips: number;
+        circuitBreakerOpen: boolean;
+        availableTokens: number;
+    };
+    /**
+     * Reset statistics
+     */
+    resetStats(): void;
+}
+/**
+ * Wrap any provider with resilience features
+ */
+export declare function withResilience(provider: LLMProvider, config?: ResilientProviderConfig): ResilientProvider;
+/**
+ * Provider-specific recommended configurations
+ */
+export declare const PROVIDER_RESILIENCE_CONFIGS: Record<string, ResilientProviderConfig>;
+/**
+ * Wrap a provider with resilience using provider-specific defaults
+ */
+export declare function withProviderResilience(provider: LLMProvider, providerId: string, overrides?: Partial<ResilientProviderConfig>): ResilientProvider;
+//# sourceMappingURL=resilientProvider.d.ts.map

package/dist/providers/resilientProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resilientProvider.d.ts","sourceRoot":"","sources":["../../src/providers/resilientProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,EAChB,WAAW,EACX,UAAU,EACX,MAAM,kBAAkB,CAAC;AAO1B,MAAM,WAAW,uBAAuB;IACtC,gDAAgD;IAChD,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,2DAA2D;IAC3D,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,wDAAwD;IACxD,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAmHD;;GAEG;AACH,qBAAa,iBAAkB,YAAW,WAAW;IACnD,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;IAC3D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsB;IACrD,OAAO,CAAC,KAAK,CAKX;gBAEU,QAAQ,EAAE,WAAW,EAAE,MAAM,GAAE,uBAA4B;IA0BvE;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAkB3B;;OAEG;IACH,OAAO,CAAC,aAAa;IAYrB;;OAEG;IACH,OAAO,CAAC,aAAa;IAMrB;;OAEG;YACW,qBAAqB;IAyCnC;;OAEG;IACG,QAAQ,CACZ,QAAQ,EAAE,mBAAmB,EAAE,EAC/B,KAAK,EAAE,sBAAsB,EAAE,GAC9B,OAAO,CAAC,gBAAgB,CAAC;IAO5B;;;;;OAKG;IACI,cAAc,CACnB,QAAQ,EAAE,mBAAmB,EAAE,EAC/B,KAAK,EAAE,sBAAsB,EAAE,GAC9B,qBAAqB,CAAC,WAAW,CAAC;IAoErC;;OAEG;IACH,QAAQ,IAAI;QACV,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,kBAAkB,EAAE,OAAO,CAAC;QAC5B,eAAe,EAAE,MAAM,CAAC;KACzB;IAQD;;OAEG;IACH,UAAU,IAAI,IAAI;CAQnB;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,WAAW,EACrB,MAAM,CAAC,EAAE,uBAAuB,GAC/B,iBAAiB,CAEnB;AAED;;GAEG;AACH,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAsC/E,CAAC;AAEF;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,WAAW,EACrB,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAC3C,iBAAiB,CAGnB"}