erosolar-cli 2.1.231 → 2.1.234

package/dist/providers/baseProvider.js

@@ -0,0 +1,284 @@
+/**
+ * Base Provider - Abstract LLM Provider Implementation
+ *
+ * Provides common functionality for LLM providers:
+ * - Retry logic with exponential backoff
+ * - Rate limit handling
+ * - Transient error recovery
+ * - Message conversion utilities
+ * - Usage tracking
+ *
+ * Usage:
+ * ```typescript
+ * class MyProvider extends BaseProvider {
+ *   readonly id = 'my-provider';
+ *
+ *   protected async doGenerate(messages, tools): Promise<ProviderResponse> {
+ *     // Provider-specific implementation
+ *   }
+ *
+ *   protected async doGenerateStream(messages, tools): AsyncIterable<StreamChunk> {
+ *     // Provider-specific implementation
+ *   }
+ * }
+ * ```
+ */
+// ═══════════════════════════════════════════════════════════════════════════════
+// Constants
+// ═══════════════════════════════════════════════════════════════════════════════
+/** Patterns that indicate transient/retryable errors */
+export const TRANSIENT_ERROR_PATTERNS = [
+    'premature close',
+    'premature end',
+    'unexpected end',
+    'aborted',
+    'fetcherror',
+    'invalid response body',
+    'gunzip',
+    'decompress',
+    'econnreset',
+    'econnrefused',
+    'epipe',
+    'socket hang up',
+    'network',
+    'timeout',
+    '500',
+    '502',
+    '503',
+    '504',
+    'overloaded',
+];
+/** Default retry configuration */
+export const DEFAULT_RETRY_CONFIG = {
+    maxRetries: 3,
+    initialDelayMs: 1000,
+    maxDelayMs: 30000,
+    backoffMultiplier: 2,
+};
+/** Default rate limit configuration */
+export const DEFAULT_RATE_LIMIT_CONFIG = {
+    maxRetries: 4,
+    initialDelayMs: 1500,
+    minDelayMs: 750,
+    maxDelayMs: 40000,
+};
+// ═══════════════════════════════════════════════════════════════════════════════
+// Error Detection Utilities
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * Check if an error is transient and can be retried
+ */
+export function isTransientError(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 TRANSIENT_ERROR_PATTERNS.some((pattern) => allText.includes(pattern));
+}
+/**
+ * Check if an error is a rate limit error
+ */
+export function isRateLimitError(error) {
+    if (!(error instanceof Error))
+        return false;
+    const message = error.message.toLowerCase();
+    // Check for common rate limit indicators
+    if (message.includes('rate limit') ||
+        message.includes('rate_limit') ||
+        message.includes('too many requests') ||
+        message.includes('429')) {
+        return true;
+    }
+    // Check for status code
+    const status = error.status;
+    return status === 429;
+}
+/**
+ * Check if an error is an authentication error
+ */
+export function isAuthError(error) {
+    if (!(error instanceof Error))
+        return false;
+    const message = error.message.toLowerCase();
+    const status = error.status;
+    return (status === 401 ||
+        status === 403 ||
+        message.includes('unauthorized') ||
+        message.includes('invalid api key') ||
+        message.includes('authentication'));
+}
+// ═══════════════════════════════════════════════════════════════════════════════
+// Retry Utilities
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * Sleep for a given duration
+ */
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Calculate exponential backoff delay
+ */
+export function calculateBackoffDelay(attempt, config) {
+    const delay = config.initialDelayMs * Math.pow(config.backoffMultiplier, attempt);
+    // Add jitter (±10%)
+    const jitter = delay * 0.1 * (Math.random() * 2 - 1);
+    return Math.min(delay + jitter, config.maxDelayMs);
+}
+/**
+ * Execute an operation with retry logic
+ */
+export async function withRetry(operation, options = {}) {
+    const config = {
+        ...DEFAULT_RETRY_CONFIG,
+        ...options.config,
+    };
+    const shouldRetry = options.shouldRetry ?? isTransientError;
+    let lastError;
+    for (let attempt = 0; attempt <= config.maxRetries; attempt++) {
+        try {
+            return await operation();
+        }
+        catch (error) {
+            lastError = error;
+            // Don't retry auth errors
+            if (isAuthError(error)) {
+                throw error;
+            }
+            // Check if we should retry
+            if (attempt === config.maxRetries || !shouldRetry(error)) {
+                throw error;
+            }
+            // Calculate delay and wait
+            const delay = calculateBackoffDelay(attempt, config);
+            options.onRetry?.(error, attempt, delay);
+            await sleep(delay);
+        }
+    }
+    throw lastError;
+}
+// ═══════════════════════════════════════════════════════════════════════════════
+// Message Utilities
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * Extract system message from conversation
+ */
+export function extractSystemMessage(messages) {
+    const systemMessages = messages.filter((m) => m.role === 'system');
+    const rest = messages.filter((m) => m.role !== 'system');
+    if (systemMessages.length === 0) {
+        return { system: null, rest };
+    }
+    // Combine all system messages
+    const system = systemMessages
+        .map((m) => (typeof m.content === 'string' ? m.content : JSON.stringify(m.content)))
+        .join('\n\n');
+    return { system, rest };
+}
+/**
+ * Merge consecutive messages from the same role
+ */
+export function mergeConsecutiveMessages(messages) {
+    if (messages.length === 0)
+        return [];
+    const merged = [];
+    let current = null;
+    for (const message of messages) {
+        if (!current) {
+            current = { ...message };
+            continue;
+        }
+        if (current.role === message.role && typeof current.content === 'string' && typeof message.content === 'string') {
+            // Merge text content
+            current.content = `${current.content}\n\n${message.content}`;
+        }
+        else {
+            merged.push(current);
+            current = { ...message };
+        }
+    }
+    if (current) {
+        merged.push(current);
+    }
+    return merged;
+}
+// ═══════════════════════════════════════════════════════════════════════════════
+// Usage Tracking
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * Create an empty usage object
+ */
+export function emptyUsage() {
+    return {
+        inputTokens: 0,
+        outputTokens: 0,
+        totalTokens: 0,
+    };
+}
+/**
+ * Merge usage objects
+ */
+export function mergeUsage(a, b) {
+    return {
+        inputTokens: (a.inputTokens ?? 0) + (b.inputTokens ?? 0),
+        outputTokens: (a.outputTokens ?? 0) + (b.outputTokens ?? 0),
+        totalTokens: (a.totalTokens ?? 0) + (b.totalTokens ?? 0),
+    };
+}
+// ═══════════════════════════════════════════════════════════════════════════════
+// Abstract Base Provider
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * Abstract base class for LLM providers
+ *
+ * Implements common functionality like retry logic and error handling.
+ * Subclasses must implement the abstract methods for provider-specific behavior.
+ */
+export class BaseProvider {
+    model;
+    maxTokens;
+    temperature;
+    retryConfig;
+    rateLimitConfig;
+    constructor(options) {
+        this.model = options.model;
+        this.maxTokens = options.maxTokens ?? 4096;
+        this.temperature = options.temperature ?? 0;
+        this.retryConfig = { ...DEFAULT_RETRY_CONFIG, ...options.retryConfig };
+        this.rateLimitConfig = { ...DEFAULT_RATE_LIMIT_CONFIG, ...options.rateLimitConfig };
+    }
+    /**
+     * Generate a response (implemented by subclass)
+     */
+    async generate(messages, tools) {
+        return withRetry(() => this.doGenerate(messages, tools), {
+            config: this.retryConfig,
+            shouldRetry: (error) => isTransientError(error) || isRateLimitError(error),
+            onRetry: (error, attempt, delay) => {
+                this.onRetry(error, attempt, delay);
+            },
+        });
+    }
+    /**
+     * Generate a streaming response (implemented by subclass)
+     */
+    async *generateStream(messages, tools) {
+        // Stream operations are harder to retry, so we do best-effort
+        yield* this.doGenerateStream(messages, tools);
+    }
+    /**
+     * Get available models (optional, implemented by subclass)
+     */
+    async getModels() {
+        return [];
+    }
+    /**
+     * Called when a retry is about to happen
+     */
+    onRetry(error, attempt, delay) {
+        // Subclasses can override for logging
+    }
+}
+//# sourceMappingURL=baseProvider.js.map

package/dist/providers/baseProvider.js.map

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

package/dist/shell/commandRegistry.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Command Registry - Slash Command Management
+ *
+ * Provides a registry for slash commands with:
+ * - Command registration and discovery
+ * - Help text generation
+ * - Category organization
+ * - Command execution delegation
+ *
+ * Usage:
+ * ```typescript
+ * const registry = new CommandRegistry();
+ *
+ * registry.register({
+ *   name: '/help',
+ *   aliases: ['/?'],
+ *   description: 'Show help information',
+ *   category: 'navigation',
+ *   handler: async (context) => {
+ *     context.showHelp();
+ *   },
+ * });
+ *
+ * await registry.execute('/help', '', context);
+ * ```
+ */
+export type CommandCategory = 'navigation' | 'model' | 'context' | 'session' | 'tools' | 'development' | 'security' | 'advanced' | 'learning' | 'ui';
+export interface CommandContext {
+    /** The shell instance for accessing shell methods */
+    shell: unknown;
+    /** Current input/arguments */
+    input: string;
+    /** Raw command string */
+    rawCommand: string;
+}
+export interface CommandDefinition {
+    /** Primary command name (e.g., '/help') */
+    name: string;
+    /** Alternative names for the command */
+    aliases?: string[];
+    /** Short description for help text */
+    description: string;
+    /** Category for organization */
+    category: CommandCategory;
+    /** Whether command is async */
+    async?: boolean;
+    /** Whether command is hidden from help */
+    hidden?: boolean;
+    /** Usage example */
+    usage?: string;
+    /** Handler function */
+    handler: (context: CommandContext) => void | Promise<void>;
+}
+export interface CommandMatch {
+    command: CommandDefinition;
+    matchedName: string;
+}
+export declare class CommandRegistry {
+    private commands;
+    private aliasMap;
+    /**
+     * Register a command
+     */
+    register(command: CommandDefinition): this;
+    /**
+     * Register multiple commands
+     */
+    registerAll(commands: CommandDefinition[]): this;
+    /**
+     * Find a command by name or alias
+     */
+    find(commandName: string): CommandMatch | null;
+    /**
+     * Check if a command exists
+     */
+    has(commandName: string): boolean;
+    /**
+     * Execute a command
+     */
+    execute(commandName: string, input: string, shell: unknown): Promise<boolean>;
+    /**
+     * Get all commands in a category
+     */
+    getByCategory(category: CommandCategory): CommandDefinition[];
+    /**
+     * Get all categories with their commands
+     */
+    getAllCategories(): Map<CommandCategory, CommandDefinition[]>;
+    /**
+     * Get all registered commands
+     */
+    getAll(): CommandDefinition[];
+    /**
+     * Get all visible commands (excluding hidden)
+     */
+    getVisible(): CommandDefinition[];
+    /**
+     * Generate help text for all commands
+     */
+    generateHelpText(): string;
+    /**
+     * Generate compact help text (just command names)
+     */
+    generateCompactHelp(): string;
+    /**
+     * Normalize command name
+     */
+    private normalizeName;
+    /**
+     * Format category name for display
+     */
+    private formatCategoryName;
+}
+/**
+ * Create a standard set of commands for the shell
+ *
+ * This is meant to be extended/customized by the shell implementation
+ */
+export declare function createBaseCommands(): CommandDefinition[];
+export declare function getCommandRegistry(): CommandRegistry;
+export declare function resetCommandRegistry(): void;
+//# sourceMappingURL=commandRegistry.d.ts.map

package/dist/shell/commandRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandRegistry.d.ts","sourceRoot":"","sources":["../../src/shell/commandRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAMH,MAAM,MAAM,eAAe,GACvB,YAAY,GACZ,OAAO,GACP,SAAS,GACT,SAAS,GACT,OAAO,GACP,aAAa,GACb,UAAU,GACV,UAAU,GACV,UAAU,GACV,IAAI,CAAC;AAET,MAAM,WAAW,cAAc;IAC7B,qDAAqD;IACrD,KAAK,EAAE,OAAO,CAAC;IACf,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,QAAQ,EAAE,eAAe,CAAC;IAC1B,+BAA+B;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,OAAO,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5D;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,QAAQ,CAA6B;IAE7C;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAgB1C;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,IAAI;IAOhD;;OAEG;IACH,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAqB9C;;OAEG;IACH,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAIjC;;OAEG;IACG,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAqBnF;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,eAAe,GAAG,iBAAiB,EAAE;IAM7D;;OAEG;IACH,gBAAgB,IAAI,GAAG,CAAC,eAAe,EAAE,iBAAiB,EAAE,CAAC;IAc7D;;OAEG;IACH,MAAM,IAAI,iBAAiB,EAAE;IAI7B;;OAEG;IACH,UAAU,IAAI,iBAAiB,EAAE;IAIjC;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAkC1B;;OAEG;IACH,mBAAmB,IAAI,MAAM;IAO7B;;OAEG;IACH,OAAO,CAAC,aAAa;IAIrB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAe3B;AAMD;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,iBAAiB,EAAE,CAyJxD;AAQD,wBAAgB,kBAAkB,IAAI,eAAe,CAMpD;AAED,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C"}