erosolar-cli 1.7.439 → 1.7.440

package/dist/providers/resilientProvider.js

@@ -0,0 +1,370 @@
+/**
+ * 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 { RateLimiter, retry, sleep } from '../utils/asyncUtils.js';
+// ============================================================================
+// Rate Limit Error Detection
+// ============================================================================
+const RATE_LIMIT_PATTERNS = [
+    'rate limit',
+    'rate_limit',
+    'ratelimit',
+    'too many requests',
+    '429',
+    'quota exceeded',
+    'request limit',
+    'throttled',
+    'overloaded',
+    'capacity',
+];
+const TRANSIENT_ERROR_PATTERNS = [
+    'timeout',
+    'timed out',
+    'network',
+    'connection',
+    'econnrefused',
+    'econnreset',
+    'enotfound',
+    'epipe',
+    'econnaborted',
+    'ehostunreach',
+    'enetunreach',
+    'socket',
+    'temporarily unavailable',
+    '502',
+    '503',
+    '504',
+    'bad gateway',
+    'service unavailable',
+    'gateway timeout',
+    'internal server error',
+    '500',
+    // Stream and fetch errors
+    'premature close',
+    'premature end',
+    'unexpected end',
+    'stream',
+    'aborted',
+    'fetcherror',
+    'fetch error',
+    'invalid response body',
+    'response body',
+    'gunzip',
+    'decompress',
+    'zlib',
+    'content-encoding',
+    'chunked encoding',
+    'transfer-encoding',
+    // SSL/TLS errors
+    'ssl',
+    'tls',
+    'certificate',
+    'cert',
+    'handshake',
+];
+function isRateLimitError(error) {
+    if (!(error instanceof Error))
+        return false;
+    const message = error.message.toLowerCase();
+    return RATE_LIMIT_PATTERNS.some(pattern => message.includes(pattern));
+}
+function isTransientError(error) {
+    if (!(error instanceof Error))
+        return false;
+    // Check message
+    const message = error.message.toLowerCase();
+    if (TRANSIENT_ERROR_PATTERNS.some(pattern => message.includes(pattern))) {
+        return true;
+    }
+    // Check error name/type (FetchError, AbortError, etc.)
+    const errorName = error.name?.toLowerCase() ?? '';
+    if (errorName.includes('fetch') || errorName.includes('abort') || errorName.includes('network')) {
+        return true;
+    }
+    // Check error code if present (Node.js style)
+    const errorCode = error.code?.toLowerCase() ?? '';
+    if (errorCode && TRANSIENT_ERROR_PATTERNS.some(pattern => errorCode.includes(pattern))) {
+        return true;
+    }
+    // Check cause chain for nested errors
+    const cause = error.cause;
+    if (cause instanceof Error) {
+        return isTransientError(cause);
+    }
+    return false;
+}
+function shouldRetry(error) {
+    return isRateLimitError(error) || isTransientError(error);
+}
+// ============================================================================
+// Resilient Provider Implementation
+// ============================================================================
+/**
+ * Wraps any LLM provider with rate limiting and retry logic
+ */
+export class ResilientProvider {
+    id;
+    model;
+    provider;
+    rateLimiter;
+    config;
+    circuitBreaker;
+    stats = {
+        totalRequests: 0,
+        rateLimitHits: 0,
+        retries: 0,
+        circuitBreakerTrips: 0,
+    };
+    constructor(provider, config = {}) {
+        this.provider = provider;
+        this.id = provider.id;
+        this.model = provider.model;
+        this.config = {
+            maxRequestsPerMinute: config.maxRequestsPerMinute ?? 50,
+            maxRetries: config.maxRetries ?? 4,
+            baseDelayMs: config.baseDelayMs ?? 1000,
+            maxDelayMs: config.maxDelayMs ?? 32000,
+            enableCircuitBreaker: config.enableCircuitBreaker ?? true,
+            circuitBreakerThreshold: config.circuitBreakerThreshold ?? 5,
+            circuitBreakerResetMs: config.circuitBreakerResetMs ?? 60000,
+        };
+        this.rateLimiter = new RateLimiter({
+            maxRequests: this.config.maxRequestsPerMinute,
+            windowMs: 60000,
+        });
+        this.circuitBreaker = {
+            failures: 0,
+            lastFailure: 0,
+            isOpen: false,
+        };
+    }
+    /**
+     * Check and potentially reset circuit breaker
+     */
+    checkCircuitBreaker() {
+        if (!this.config.enableCircuitBreaker)
+            return;
+        if (this.circuitBreaker.isOpen) {
+            const elapsed = Date.now() - this.circuitBreaker.lastFailure;
+            if (elapsed >= this.config.circuitBreakerResetMs) {
+                // Half-open: allow one request through
+                this.circuitBreaker.isOpen = false;
+                this.circuitBreaker.failures = Math.floor(this.circuitBreaker.failures / 2);
+            }
+            else {
+                throw new Error(`Circuit breaker is open. Too many failures (${this.circuitBreaker.failures}). ` +
+                    `Retry in ${Math.ceil((this.config.circuitBreakerResetMs - elapsed) / 1000)}s.`);
+            }
+        }
+    }
+    /**
+     * Record a failure for circuit breaker
+     */
+    recordFailure(_error) {
+        if (!this.config.enableCircuitBreaker)
+            return;
+        this.circuitBreaker.failures++;
+        this.circuitBreaker.lastFailure = Date.now();
+        if (this.circuitBreaker.failures >= this.config.circuitBreakerThreshold) {
+            this.circuitBreaker.isOpen = true;
+            this.stats.circuitBreakerTrips++;
+        }
+    }
+    /**
+     * Record a success to reset circuit breaker
+     */
+    recordSuccess() {
+        if (this.config.enableCircuitBreaker && this.circuitBreaker.failures > 0) {
+            this.circuitBreaker.failures = Math.max(0, this.circuitBreaker.failures - 1);
+        }
+    }
+    /**
+     * Execute a request with rate limiting and retry
+     */
+    async executeWithResilience(operation, _operationName) {
+        this.stats.totalRequests++;
+        // Check circuit breaker
+        this.checkCircuitBreaker();
+        // Acquire rate limit token
+        await this.rateLimiter.acquire();
+        try {
+            const result = await retry(operation, {
+                maxRetries: this.config.maxRetries,
+                baseDelayMs: this.config.baseDelayMs,
+                maxDelayMs: this.config.maxDelayMs,
+                backoffMultiplier: 2,
+                shouldRetry: (error) => {
+                    if (shouldRetry(error)) {
+                        this.stats.retries++;
+                        if (isRateLimitError(error)) {
+                            this.stats.rateLimitHits++;
+                        }
+                        return true;
+                    }
+                    return false;
+                },
+            });
+            this.recordSuccess();
+            return result;
+        }
+        catch (error) {
+            this.recordFailure(error);
+            throw error;
+        }
+    }
+    /**
+     * Generate a response with resilience
+     */
+    async generate(messages, tools) {
+        return this.executeWithResilience(() => this.provider.generate(messages, tools), 'generate');
+    }
+    /**
+     * Generate a streaming response with resilience
+     *
+     * Note: Retry logic is limited for streaming - we can only retry
+     * before the stream starts, not mid-stream.
+     */
+    async *generateStream(messages, tools) {
+        if (!this.provider.generateStream) {
+            // Fall back to non-streaming
+            const response = await this.generate(messages, tools);
+            if (response.type === 'message') {
+                yield { type: 'content', content: response.content };
+            }
+            else if (response.type === 'tool_calls') {
+                if (response.content) {
+                    yield { type: 'content', content: response.content };
+                }
+                if (response.toolCalls) {
+                    for (const call of response.toolCalls) {
+                        yield { type: 'tool_call', toolCall: call };
+                    }
+                }
+            }
+            if (response.usage) {
+                yield { type: 'usage', usage: response.usage };
+            }
+            return;
+        }
+        this.stats.totalRequests++;
+        // Check circuit breaker
+        this.checkCircuitBreaker();
+        // Acquire rate limit token
+        await this.rateLimiter.acquire();
+        let attempts = 0;
+        let lastError;
+        while (attempts <= this.config.maxRetries) {
+            try {
+                const stream = this.provider.generateStream(messages, tools);
+                for await (const chunk of stream) {
+                    yield chunk;
+                }
+                this.recordSuccess();
+                return;
+            }
+            catch (err) {
+                lastError = err;
+                attempts++;
+                if (attempts <= this.config.maxRetries && shouldRetry(err)) {
+                    this.stats.retries++;
+                    if (isRateLimitError(err)) {
+                        this.stats.rateLimitHits++;
+                    }
+                    const delay = Math.min(this.config.baseDelayMs * Math.pow(2, attempts - 1), this.config.maxDelayMs);
+                    await sleep(delay);
+                    continue;
+                }
+                this.recordFailure(err);
+                throw err;
+            }
+        }
+        this.recordFailure(lastError);
+        throw lastError;
+    }
+    /**
+     * Get resilience statistics
+     */
+    getStats() {
+        return {
+            ...this.stats,
+            circuitBreakerOpen: this.circuitBreaker.isOpen,
+            availableTokens: this.rateLimiter.availableTokens,
+        };
+    }
+    /**
+     * Reset statistics
+     */
+    resetStats() {
+        this.stats = {
+            totalRequests: 0,
+            rateLimitHits: 0,
+            retries: 0,
+            circuitBreakerTrips: 0,
+        };
+    }
+}
+// ============================================================================
+// Factory Function
+// ============================================================================
+/**
+ * Wrap any provider with resilience features
+ */
+export function withResilience(provider, config) {
+    return new ResilientProvider(provider, config);
+}
+/**
+ * Provider-specific recommended configurations
+ */
+export const PROVIDER_RESILIENCE_CONFIGS = {
+    anthropic: {
+        maxRequestsPerMinute: 50,
+        maxRetries: 4,
+        baseDelayMs: 1500,
+        maxDelayMs: 40000,
+    },
+    openai: {
+        maxRequestsPerMinute: 60,
+        maxRetries: 3,
+        baseDelayMs: 1000,
+        maxDelayMs: 30000,
+    },
+    google: {
+        maxRequestsPerMinute: 60,
+        maxRetries: 3,
+        baseDelayMs: 1000,
+        maxDelayMs: 30000,
+    },
+    deepseek: {
+        maxRequestsPerMinute: 30,
+        maxRetries: 4,
+        baseDelayMs: 2000,
+        maxDelayMs: 45000,
+    },
+    xai: {
+        maxRequestsPerMinute: 40,
+        maxRetries: 3,
+        baseDelayMs: 1500,
+        maxDelayMs: 35000,
+    },
+    ollama: {
+        maxRequestsPerMinute: 100,
+        maxRetries: 2,
+        baseDelayMs: 500,
+        maxDelayMs: 10000,
+        enableCircuitBreaker: false, // Local, less likely to need circuit breaker
+    },
+};
+/**
+ * Wrap a provider with resilience using provider-specific defaults
+ */
+export function withProviderResilience(provider, providerId, overrides) {
+    const defaults = PROVIDER_RESILIENCE_CONFIGS[providerId] ?? {};
+    return new ResilientProvider(provider, { ...defaults, ...overrides });
+}
+//# sourceMappingURL=resilientProvider.js.map

package/dist/providers/resilientProvider.js.map

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

package/dist/runtime/agentController.d.ts

@@ -0,0 +1,65 @@
+import type { ProfileName } from '../config.js';
+import type { UniversalRuntime } from './universal.js';
+import { type NodeRuntimeOptions } from './node.js';
+import type { CapabilityModule } from './agentHost.js';
+import type { AgentCallbacks } from '../core/agent.js';
+import type { ToolRuntimeObserver, ToolSuite } from '../core/toolRuntime.js';
+import type { ConversationMessage } from '../core/types.js';
+import type { AgentEventUnion, CapabilityManifest, IAgentController, ModelConfig } from '../contracts/v1/agent.js';
+interface EventSinkRef {
+    current: EventStream<AgentEventUnion> | null;
+}
+declare class EventStream<T> implements AsyncIterableIterator<T> {
+    private readonly queue;
+    private pending;
+    private closed;
+    private failure;
+    push(value: T): void;
+    close(): void;
+    fail(error: Error): void;
+    next(): Promise<IteratorResult<T>>;
+    return(): Promise<IteratorResult<T>>;
+    throw(error: unknown): Promise<IteratorResult<T>>;
+    [Symbol.asyncIterator](): AsyncIterableIterator<T>;
+}
+interface AgentControllerDependencies {
+    runtime: UniversalRuntime;
+    sinkRef: EventSinkRef;
+    externalCallbacks?: AgentCallbacks;
+}
+export interface AgentControllerCreateOptions extends Omit<NodeRuntimeOptions, 'toolObserver'> {
+    profile: ProfileName;
+    workspaceContext: string | null;
+    workingDir: string;
+    modules?: CapabilityModule[];
+    callbacks?: AgentCallbacks;
+}
+export declare function createAgentController(options: AgentControllerCreateOptions, additionalObserver?: ToolRuntimeObserver): Promise<AgentController>;
+export declare class AgentController implements IAgentController {
+    private readonly session;
+    private readonly sinkRef;
+    private readonly externalCallbacks;
+    private activeSink;
+    private agent;
+    private cachedHistory;
+    private selection;
+    constructor(dependencies: AgentControllerDependencies);
+    private buildInitialSelection;
+    private ensureAgent;
+    private createAgentCallbacks;
+    private emitDelta;
+    private emitError;
+    private emitUsage;
+    private handleAssistantMessage;
+    private updateCachedHistory;
+    send(message: string): AsyncIterableIterator<AgentEventUnion>;
+    switchModel(config: ModelConfig): Promise<void>;
+    getCapabilities(): CapabilityManifest;
+    registerToolSuite(suiteId: string, suite: ToolSuite): void;
+    unregisterToolSuite(suiteId: string): void;
+    getHistory(): ConversationMessage[];
+    clearHistory(): void;
+    private toModelConfig;
+}
+export {};
+//# sourceMappingURL=agentController.d.ts.map

package/dist/runtime/agentController.d.ts.map

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