erosolar-cli 1.7.439 → 1.7.440

package/dist/core/types/utilityTypes.js

@@ -0,0 +1,272 @@
+/**
+ * TypeScript Utility Types and Helper Functions
+ *
+ * Provides comprehensive TypeScript utilities for:
+ * - Advanced type manipulation
+ * - Functional programming patterns
+ * - Immutable data structures
+ * - Runtime type checking
+ */
+/**
+ * Runtime type checking utilities
+ */
+export class TypeGuards {
+    /**
+     * Check if value is a string
+     */
+    static isString(value) {
+        return typeof value === 'string';
+    }
+    /**
+     * Check if value is a number
+     */
+    static isNumber(value) {
+        return typeof value === 'number' && !isNaN(value);
+    }
+    /**
+     * Check if value is a boolean
+     */
+    static isBoolean(value) {
+        return typeof value === 'boolean';
+    }
+    /**
+     * Check if value is an object (not null, not array)
+     */
+    static isObject(value) {
+        return typeof value === 'object' && value !== null && !Array.isArray(value);
+    }
+    /**
+     * Check if value is an array
+     */
+    static isArray(value) {
+        return Array.isArray(value);
+    }
+    /**
+     * Check if value is a function
+     */
+    static isFunction(value) {
+        return typeof value === 'function';
+    }
+    /**
+     * Check if value is null or undefined
+     */
+    static isNil(value) {
+        return value === null || value === undefined;
+    }
+    /**
+     * Check if value has a specific property
+     */
+    static hasProperty(value, property) {
+        return TypeGuards.isObject(value) && property in value;
+    }
+}
+/**
+ * Functional programming utilities
+ */
+export class Functional {
+    /**
+     * Compose multiple functions
+     */
+    static compose(...fns) {
+        return (x) => fns.reduceRight((acc, fn) => fn(acc), x);
+    }
+    /**
+     * Pipe value through multiple functions
+     */
+    static pipe(value, ...fns) {
+        return fns.reduce((acc, fn) => fn(acc), value);
+    }
+    /**
+     * Memoize function with cache
+     */
+    static memoize(fn, cacheKey) {
+        const cache = new Map();
+        return ((...args) => {
+            const key = cacheKey ? cacheKey(...args) : JSON.stringify(args);
+            if (cache.has(key)) {
+                return cache.get(key);
+            }
+            const result = fn(...args);
+            cache.set(key, result);
+            return result;
+        });
+    }
+    /**
+     * Debounce function execution
+     */
+    static debounce(fn, delay) {
+        let timeoutId;
+        return (...args) => {
+            clearTimeout(timeoutId);
+            timeoutId = setTimeout(() => fn(...args), delay);
+        };
+    }
+    /**
+     * Throttle function execution
+     */
+    static throttle(fn, delay) {
+        let lastCall = 0;
+        return (...args) => {
+            const now = Date.now();
+            if (now - lastCall >= delay) {
+                lastCall = now;
+                fn(...args);
+            }
+        };
+    }
+}
+/**
+ * Immutable data utilities
+ */
+export class Immutable {
+    /**
+     * Deep freeze object
+     */
+    static deepFreeze(obj) {
+        if (typeof obj !== 'object' || obj === null) {
+            return obj;
+        }
+        Object.freeze(obj);
+        Object.getOwnPropertyNames(obj).forEach(prop => {
+            const value = obj[prop];
+            if (value &&
+                typeof value === 'object' &&
+                !Object.isFrozen(value)) {
+                Immutable.deepFreeze(value);
+            }
+        });
+        return obj;
+    }
+    /**
+     * Create immutable copy with updates
+     */
+    static update(obj, updates) {
+        return { ...obj, ...updates };
+    }
+    /**
+     * Create immutable copy with nested updates
+     */
+    static updateIn(obj, path, value) {
+        if (path.length === 0) {
+            return obj;
+        }
+        const [first, ...rest] = path;
+        if (rest.length === 0) {
+            return { ...obj, [first]: value };
+        }
+        const current = obj[first];
+        if (!TypeGuards.isObject(current)) {
+            throw new Error(`Cannot update non-object at path: ${first}`);
+        }
+        return {
+            ...obj,
+            [first]: Immutable.updateIn(current, rest, value)
+        };
+    }
+}
+/**
+ * Type-safe event emitter
+ */
+export class TypedEventEmitter {
+    listeners = {};
+    /**
+     * Add event listener
+     */
+    on(event, listener) {
+        if (!this.listeners[event]) {
+            this.listeners[event] = [];
+        }
+        this.listeners[event].push(listener);
+    }
+    /**
+     * Remove event listener
+     */
+    off(event, listener) {
+        if (!this.listeners[event]) {
+            return;
+        }
+        const index = this.listeners[event].indexOf(listener);
+        if (index !== -1) {
+            this.listeners[event].splice(index, 1);
+        }
+    }
+    /**
+     * Emit event
+     */
+    emit(event, ...args) {
+        if (!this.listeners[event]) {
+            return;
+        }
+        this.listeners[event].forEach(listener => {
+            try {
+                listener(...args);
+            }
+            catch (error) {
+                console.error(`Error in event listener for ${String(event)}:`, error);
+            }
+        });
+    }
+    /**
+     * Remove all listeners
+     */
+    removeAllListeners() {
+        this.listeners = {};
+    }
+}
+/**
+ * Utility functions for common TypeScript patterns
+ */
+export class TypeScriptUtils {
+    /**
+     * Assert value is not null or undefined
+     */
+    static assertDefined(value, message) {
+        if (value === null || value === undefined) {
+            throw new Error(message ?? 'Value is null or undefined');
+        }
+    }
+    /**
+     * Create type-safe enum from array
+     */
+    static createStringEnum(values) {
+        return values.reduce((acc, value) => {
+            acc[value] = value;
+            return acc;
+        }, {});
+    }
+    /**
+     * Create branded type
+     */
+    static createBranded(value) {
+        return value;
+    }
+    /**
+     * Extract keys from type that match a condition
+     */
+    static extractKeys(obj, predicate) {
+        return Object.keys(obj).filter(key => predicate(key, obj[key]));
+    }
+    /**
+     * Pick properties from object
+     */
+    static pick(obj, keys) {
+        const result = {};
+        keys.forEach(key => {
+            if (key in obj) {
+                result[key] = obj[key];
+            }
+        });
+        return result;
+    }
+    /**
+     * Omit properties from object
+     */
+    static omit(obj, keys) {
+        const result = { ...obj };
+        keys.forEach(key => {
+            delete result[key];
+        });
+        return result;
+    }
+}
+//# sourceMappingURL=utilityTypes.js.map

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

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

package/dist/core/types.d.ts

@@ -0,0 +1,306 @@
+/**
+ * AI Provider identifier for multi-provider support
+ */
+export type ProviderId = string;
+/**
+ * Reasoning effort levels for AI model optimization
+ */
+export type ReasoningEffortLevel = 'low' | 'medium' | 'high';
+/**
+ * Text verbosity levels for output control
+ */
+export type TextVerbosityLevel = 'low' | 'medium' | 'high';
+/**
+ * Conversation roles in AI message flow
+ */
+export type ConversationRole = 'system' | 'user' | 'assistant' | 'tool';
+export interface SystemMessage {
+    role: 'system';
+    content: string;
+}
+export interface UserMessage {
+    role: 'user';
+    content: string;
+}
+export interface ToolCallArguments {
+    [key: string]: unknown;
+}
+export interface ToolCallRequest {
+    id: string;
+    name: string;
+    arguments: ToolCallArguments;
+}
+export interface AssistantMessage {
+    role: 'assistant';
+    content: string;
+    toolCalls?: ToolCallRequest[];
+}
+export interface ToolMessage {
+    role: 'tool';
+    name: string;
+    content: string;
+    toolCallId: string;
+}
+/**
+ * Enhanced discriminated union for type-safe tool responses
+ * Provides comprehensive error handling and metadata tracking
+ */
+export interface ToolSuccessResponse {
+    readonly type: 'success';
+    readonly content: string;
+    readonly metadata?: {
+        readonly linesRead?: number;
+        readonly fileSize?: number;
+        readonly executionTime?: number;
+        readonly cacheHit?: boolean;
+        readonly toolName?: string;
+        readonly timestamp?: number;
+    };
+}
+/**
+ * Structured error response with recovery guidance
+ */
+export interface ToolErrorResponse {
+    readonly type: 'error';
+    readonly error: {
+        readonly code: string;
+        readonly message: string;
+        readonly details?: Readonly<Record<string, unknown>>;
+        readonly suggestion?: string;
+        readonly recoverable: boolean;
+        readonly toolName?: string;
+    };
+}
+/**
+ * Warning response with actionable suggestions
+ */
+export interface ToolWarningResponse {
+    readonly type: 'warning';
+    readonly content: string;
+    readonly warnings: ReadonlyArray<{
+        readonly code: string;
+        readonly message: string;
+        readonly severity: 'critical' | 'warning' | 'info';
+        readonly suggestion: string;
+    }>;
+}
+/**
+ * Progress update for long-running operations
+ */
+export interface ToolProgressResponse {
+    readonly type: 'progress';
+    readonly progress: number;
+    readonly message: string;
+    readonly metadata?: {
+        readonly estimatedRemaining?: number;
+        readonly currentStep?: string;
+    };
+}
+/**
+ * Comprehensive tool response union for AI flow control
+ */
+export type ToolResponse = ToolSuccessResponse | ToolErrorResponse | ToolWarningResponse | ToolProgressResponse;
+/**
+ * Type guard for successful tool responses
+ */
+export declare function isToolSuccess(response: ToolResponse): response is ToolSuccessResponse;
+/**
+ * Type guard for error tool responses
+ */
+export declare function isToolError(response: ToolResponse): response is ToolErrorResponse;
+/**
+ * Type guard for warning tool responses
+ */
+export declare function isToolWarning(response: ToolResponse): response is ToolWarningResponse;
+/**
+ * Type guard for progress tool responses
+ */
+export declare function isToolProgress(response: ToolResponse): response is ToolProgressResponse;
+export type ConversationMessage = SystemMessage | UserMessage | AssistantMessage | ToolMessage;
+/**
+ * Base interface for all JSON Schema property definitions
+ */
+export interface JSONSchemaPropertyBase {
+    readonly description?: string;
+    readonly nullable?: boolean;
+    readonly deprecated?: boolean;
+    readonly readOnly?: boolean;
+    readonly writeOnly?: boolean;
+}
+/**
+ * String schema with validation constraints
+ */
+export interface JSONSchemaString extends JSONSchemaPropertyBase {
+    readonly type: 'string';
+    readonly enum?: ReadonlyArray<string>;
+    readonly minLength?: number;
+    readonly maxLength?: number;
+    readonly pattern?: string;
+    readonly format?: 'date-time' | 'email' | 'uri' | 'uuid' | 'hostname';
+    readonly default?: string;
+}
+/**
+ * Number schema with validation constraints
+ */
+export interface JSONSchemaNumber extends JSONSchemaPropertyBase {
+    readonly type: 'number';
+    readonly minimum?: number;
+    readonly maximum?: number;
+    readonly exclusiveMinimum?: number;
+    readonly exclusiveMaximum?: number;
+    readonly multipleOf?: number;
+    readonly default?: number;
+}
+/**
+ * Boolean schema
+ */
+export interface JSONSchemaBoolean extends JSONSchemaPropertyBase {
+    readonly type: 'boolean';
+    readonly default?: boolean;
+}
+/**
+ * Array schema with item validation
+ */
+export interface JSONSchemaArray extends JSONSchemaPropertyBase {
+    readonly type: 'array';
+    readonly items: JSONSchemaProperty;
+    readonly minItems?: number;
+    readonly maxItems?: number;
+    readonly uniqueItems?: boolean;
+}
+/**
+ * Union type for all JSON Schema property types
+ */
+export type JSONSchemaProperty = JSONSchemaString | JSONSchemaNumber | JSONSchemaBoolean | JSONSchemaArray | JSONSchemaObject;
+/**
+ * Object schema with property validation
+ */
+export interface JSONSchemaObject extends JSONSchemaPropertyBase {
+    readonly type: 'object';
+    readonly properties?: Readonly<Record<string, JSONSchemaProperty>>;
+    readonly required?: ReadonlyArray<string>;
+    readonly additionalProperties?: boolean;
+    readonly minProperties?: number;
+    readonly maxProperties?: number;
+}
+/**
+ * Definition of a tool available to AI providers
+ */
+export interface ProviderToolDefinition {
+    readonly name: string;
+    readonly description: string;
+    readonly parameters?: JSONSchemaObject;
+}
+/**
+ * Token usage statistics from AI provider
+ */
+export interface ProviderUsage {
+    readonly inputTokens?: number;
+    readonly outputTokens?: number;
+    readonly totalTokens?: number;
+}
+/**
+ * Why the model stopped generating - critical for agentic loop control
+ */
+export type StopReason = 'end_turn' | 'tool_use' | 'max_tokens' | 'stop_sequence';
+/**
+ * Base interface for all provider responses
+ */
+export interface ProviderResponseBase {
+    readonly usage?: ProviderUsage | null;
+    /** Why the model stopped - determines if auto-continuation is needed */
+    readonly stopReason?: StopReason;
+}
+/**
+ * Discriminated union for provider responses
+ */
+export type ProviderResponse = (ProviderResponseBase & {
+    readonly type: 'message';
+    readonly content: string;
+}) | (ProviderResponseBase & {
+    readonly type: 'tool_calls';
+    readonly toolCalls: ToolCallRequest[];
+    readonly content?: string;
+});
+/**
+ * Streaming chunk for real-time AI responses
+ */
+export interface StreamChunk {
+    readonly type: 'content' | 'reasoning' | 'tool_call' | 'usage' | 'done';
+    readonly content?: string;
+    readonly toolCall?: ToolCallRequest;
+    readonly usage?: ProviderUsage;
+    /** Stop reason from the final message - included with 'done' chunk */
+    readonly stopReason?: StopReason;
+}
+/**
+ * AI Provider interface for multi-provider support
+ */
+export interface LLMProvider {
+    readonly id: ProviderId;
+    readonly model: string;
+    generate(messages: ConversationMessage[], tools: ProviderToolDefinition[]): Promise<ProviderResponse>;
+    generateStream?(messages: ConversationMessage[], tools: ProviderToolDefinition[]): AsyncIterableIterator<StreamChunk>;
+    getCapabilities?(): ProviderCapabilities;
+}
+/**
+ * Capabilities of an AI provider
+ */
+export interface ProviderCapabilities {
+    readonly streaming: boolean;
+    readonly toolCalling: boolean;
+    readonly vision: boolean;
+    readonly functionCalling: boolean;
+    readonly maxTokens: number;
+    readonly supportedModalities: ReadonlyArray<'text' | 'image' | 'audio'>;
+}
+/**
+ * Type-safe Result pattern for error handling
+ * Eliminates the need for try-catch blocks and provides compile-time safety
+ */
+export type Result<T, E = Error> = {
+    readonly ok: true;
+    readonly value: T;
+} | {
+    readonly ok: false;
+    readonly error: E;
+};
+/**
+ * Type guard for successful Result
+ */
+export declare function isOk<T, E>(result: Result<T, E>): result is {
+    readonly ok: true;
+    readonly value: T;
+};
+/**
+ * Type guard for failed Result
+ */
+export declare function isErr<T, E>(result: Result<T, E>): result is {
+    readonly ok: false;
+    readonly error: E;
+};
+/**
+ * Creates a successful Result
+ */
+export declare function ok<T>(value: T): Result<T, never>;
+/**
+ * Creates a failed Result
+ */
+export declare function err<E>(error: E): Result<never, E>;
+/**
+ * Unwraps a Result, throwing if it's an error
+ */
+export declare function unwrap<T, E>(result: Result<T, E>): T;
+/**
+ * Unwraps a Result, returning a default value if it's an error
+ */
+export declare function unwrapOr<T, E>(result: Result<T, E>, defaultValue: T): T;
+/**
+ * Maps a successful Result to a new value
+ */
+export declare function map<T, U, E>(result: Result<T, E>, fn: (value: T) => U): Result<U, E>;
+/**
+ * Maps an error Result to a new error
+ */
+export declare function mapErr<T, E, F>(result: Result<T, E>, fn: (error: E) => F): Result<T, F>;
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/core/types.js

@@ -0,0 +1,76 @@
+/**
+ * Type guard for successful tool responses
+ */
+export function isToolSuccess(response) {
+    return response.type === 'success';
+}
+/**
+ * Type guard for error tool responses
+ */
+export function isToolError(response) {
+    return response.type === 'error';
+}
+/**
+ * Type guard for warning tool responses
+ */
+export function isToolWarning(response) {
+    return response.type === 'warning';
+}
+/**
+ * Type guard for progress tool responses
+ */
+export function isToolProgress(response) {
+    return response.type === 'progress';
+}
+/**
+ * Type guard for successful Result
+ */
+export function isOk(result) {
+    return result.ok;
+}
+/**
+ * Type guard for failed Result
+ */
+export function isErr(result) {
+    return !result.ok;
+}
+/**
+ * Creates a successful Result
+ */
+export function ok(value) {
+    return { ok: true, value };
+}
+/**
+ * Creates a failed Result
+ */
+export function err(error) {
+    return { ok: false, error };
+}
+/**
+ * Unwraps a Result, throwing if it's an error
+ */
+export function unwrap(result) {
+    if (result.ok) {
+        return result.value;
+    }
+    throw result.error;
+}
+/**
+ * Unwraps a Result, returning a default value if it's an error
+ */
+export function unwrapOr(result, defaultValue) {
+    return result.ok ? result.value : defaultValue;
+}
+/**
+ * Maps a successful Result to a new value
+ */
+export function map(result, fn) {
+    return result.ok ? { ok: true, value: fn(result.value) } : result;
+}
+/**
+ * Maps an error Result to a new error
+ */
+export function mapErr(result, fn) {
+    return result.ok ? result : { ok: false, error: fn(result.error) };
+}
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAyHA;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,QAAsB;IAClD,OAAO,QAAQ,CAAC,IAAI,KAAK,SAAS,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,QAAsB;IAChD,OAAO,QAAQ,CAAC,IAAI,KAAK,OAAO,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,QAAsB;IAClD,OAAO,QAAQ,CAAC,IAAI,KAAK,SAAS,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,QAAsB;IACnD,OAAO,QAAQ,CAAC,IAAI,KAAK,UAAU,CAAC;AACtC,CAAC;AA2KD;;GAEG;AACH,MAAM,UAAU,IAAI,CAAO,MAAoB;IAC7C,OAAO,MAAM,CAAC,EAAE,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,KAAK,CAAO,MAAoB;IAC9C,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,EAAE,CAAI,KAAQ;IAC5B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,GAAG,CAAI,KAAQ;IAC7B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM,CAAO,MAAoB;IAC/C,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACd,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IACD,MAAM,MAAM,CAAC,KAAK,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAO,MAAoB,EAAE,YAAe;IAClE,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,GAAG,CAAU,MAAoB,EAAE,EAAmB;IACpE,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;AACpE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM,CAAU,MAAoB,EAAE,EAAmB;IACvE,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AACrE,CAAC"}