@trenchwork/erosolar 1.1.16

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

@@ -0,0 +1,111 @@
+/**
+ * Comprehensive Error Classification System
+ *
+ * Provides structured error handling with:
+ * - Error categorization (dangerous, blocked, invalid, etc.)
+ * - Severity levels (critical, error, warning, info)
+ * - Auto-fixing suggestions
+ * - Recovery strategies
+ */
+export declare enum ErrorSeverity {
+    CRITICAL = "critical",// System-level failure, cannot continue
+    ERROR = "error",// Operation failed, but system stable
+    WARNING = "warning",// Risky but allowed
+    INFO = "info"
+}
+export declare enum ErrorCategory {
+    DANGEROUS = "dangerous",// Operation could harm system
+    BLOCKED = "blocked",// Explicitly forbidden by policy
+    INVALID = "invalid",// Malformed input/arguments
+    PERMISSION = "permission",// Authorization issue
+    RESOURCE = "resource",// Resource limit exceeded
+    NETWORK = "network",// Network/connectivity issue
+    TIMEOUT = "timeout",// Operation timed out
+    VALIDATION = "validation",// Schema/type validation failed
+    CONTEXT_OVERFLOW = "context_overflow",// Token/context limit exceeded
+    NOT_FOUND = "not_found",// Resource doesn't exist
+    UNKNOWN = "unknown"
+}
+export type ErrorSuggestion = {
+    readonly action: string;
+    readonly example?: string;
+    readonly autoFixable: true;
+    readonly autoFix: () => unknown;
+} | {
+    readonly action: string;
+    readonly example?: string;
+    readonly autoFixable: false;
+};
+export type StructuredErrorDetails = {
+    readonly severity: ErrorSeverity;
+    readonly category: ErrorCategory;
+    readonly message: string;
+    readonly originalInput?: string;
+    readonly suggestions: readonly ErrorSuggestion[];
+    readonly metadata?: Readonly<Record<string, unknown>>;
+    readonly timestamp: string;
+    readonly recoverable: boolean;
+};
+/**
+ * Base class for all structured errors
+ */
+export declare abstract class StructuredError extends Error {
+    readonly severity: ErrorSeverity;
+    readonly category: ErrorCategory;
+    readonly suggestions: ErrorSuggestion[];
+    readonly originalInput?: string;
+    readonly metadata?: Record<string, unknown>;
+    readonly timestamp: string;
+    readonly recoverable: boolean;
+    constructor(details: StructuredErrorDetails);
+    /**
+   * Format error for display with suggestions
+   */
+    toDisplayString(): string;
+    /**
+   * Convert to JSON for logging/telemetry
+   */
+    toJSON(): Record<string, unknown>;
+    /**
+   * Try to auto-fix the error if possible
+   */
+    tryAutoFix(): {
+        fixed: boolean;
+        result?: any;
+    };
+}
+/**
+ * Dangerous operation error - operation could harm the system
+ */
+export declare class DangerousOperationError extends StructuredError {
+    constructor(operation: string, reason: string, safeAlternative?: string);
+}
+/**
+ * Blocked operation error - explicitly forbidden by policy
+ */
+export declare class BlockedOperationError extends StructuredError {
+    constructor(operation: string, policy: string, allowedAlternatives?: string[]);
+}
+/**
+ * Context overflow error - token/character limits exceeded
+ */
+export declare class ContextOverflowError extends StructuredError {
+    constructor(actual: number, limit: number, unit?: 'tokens' | 'chars' | 'lines', truncatable?: boolean);
+}
+/**
+ * Resource error - limits exceeded
+ */
+export declare class ResourceLimitError extends StructuredError {
+    constructor(resource: string, actual: number, limit: number, reducible?: boolean);
+}
+/**
+ * Validation error - input/schema validation failed
+ */
+export declare class ValidationError extends StructuredError {
+    constructor(field: string, code: string, message: string);
+}
+/**
+ * Format any error as a structured error
+ */
+export declare function toStructuredError(error: unknown): StructuredError;
+//# sourceMappingURL=errorTypes.d.ts.map

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

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

package/dist/core/errors/errorTypes.js

@@ -0,0 +1,345 @@
+/**
+ * Comprehensive Error Classification System
+ *
+ * Provides structured error handling with:
+ * - Error categorization (dangerous, blocked, invalid, etc.)
+ * - Severity levels (critical, error, warning, info)
+ * - Auto-fixing suggestions
+ * - Recovery strategies
+ */
+export var ErrorSeverity;
+(function (ErrorSeverity) {
+    ErrorSeverity["CRITICAL"] = "critical";
+    ErrorSeverity["ERROR"] = "error";
+    ErrorSeverity["WARNING"] = "warning";
+    ErrorSeverity["INFO"] = "info";
+})(ErrorSeverity || (ErrorSeverity = {}));
+export var ErrorCategory;
+(function (ErrorCategory) {
+    ErrorCategory["DANGEROUS"] = "dangerous";
+    ErrorCategory["BLOCKED"] = "blocked";
+    ErrorCategory["INVALID"] = "invalid";
+    ErrorCategory["PERMISSION"] = "permission";
+    ErrorCategory["RESOURCE"] = "resource";
+    ErrorCategory["NETWORK"] = "network";
+    ErrorCategory["TIMEOUT"] = "timeout";
+    ErrorCategory["VALIDATION"] = "validation";
+    ErrorCategory["CONTEXT_OVERFLOW"] = "context_overflow";
+    ErrorCategory["NOT_FOUND"] = "not_found";
+    ErrorCategory["UNKNOWN"] = "unknown";
+})(ErrorCategory || (ErrorCategory = {}));
+/**
+ * Base class for all structured errors
+ */
+export class StructuredError extends Error {
+    severity;
+    category;
+    suggestions;
+    originalInput;
+    metadata;
+    timestamp;
+    recoverable;
+    constructor(details) {
+        super(details.message);
+        this.name = this.constructor.name;
+        this.severity = details.severity;
+        this.category = details.category;
+        this.suggestions = [...details.suggestions]; // Copy to mutable array
+        this.originalInput = details.originalInput;
+        this.metadata = details.metadata;
+        this.timestamp = details.timestamp;
+        this.recoverable = details.recoverable;
+        // Maintain proper stack trace
+        Error.captureStackTrace(this, this.constructor);
+    }
+    /**
+   * Format error for display with suggestions
+   */
+    toDisplayString() {
+        const parts = [
+            `[${this.severity.toUpperCase()}] ${this.message}`,
+        ];
+        if (this.originalInput) {
+            parts.push(`  Input: ${this.originalInput}`);
+        }
+        if (this.suggestions.length > 0) {
+            parts.push('\nSuggestions:');
+            for (const suggestion of this.suggestions) {
+                parts.push(`  • ${suggestion.action}`);
+                if (suggestion.example) {
+                    parts.push(`    Example: ${suggestion.example}`);
+                }
+                if (suggestion.autoFixable) {
+                    parts.push(`    [Auto-fixable]`);
+                }
+            }
+        }
+        return parts.join('\n');
+    }
+    /**
+   * Convert to JSON for logging/telemetry
+   */
+    toJSON() {
+        return {
+            name: this.name,
+            severity: this.severity,
+            category: this.category,
+            message: this.message,
+            originalInput: this.originalInput,
+            suggestions: this.suggestions.map(s => ({
+                action: s.action,
+                example: s.example,
+                autoFixable: s.autoFixable,
+            })),
+            metadata: this.metadata,
+            timestamp: this.timestamp,
+            recoverable: this.recoverable,
+            stack: this.stack,
+        };
+    }
+    /**
+   * Try to auto-fix the error if possible
+   */
+    tryAutoFix() {
+        for (const suggestion of this.suggestions) {
+            if (suggestion.autoFixable && suggestion.autoFix) {
+                try {
+                    const result = suggestion.autoFix();
+                    return { fixed: true, result };
+                }
+                catch {
+                    // Continue to next suggestion
+                }
+            }
+        }
+        return { fixed: false };
+    }
+}
+/**
+ * Dangerous operation error - operation could harm the system
+ */
+export class DangerousOperationError extends StructuredError {
+    constructor(operation, reason, safeAlternative) {
+        const suggestions = [];
+        if (safeAlternative) {
+            suggestions.push({
+                action: `Use safer alternative: ${safeAlternative}`,
+                example: safeAlternative,
+                autoFixable: true,
+                autoFix: () => safeAlternative,
+            });
+        }
+        else {
+            suggestions.push({
+                action: 'Review operation for safety before retrying',
+                autoFixable: false,
+            });
+        }
+        super({
+            severity: ErrorSeverity.CRITICAL,
+            category: ErrorCategory.DANGEROUS,
+            message: `Dangerous operation blocked: ${operation}. Reason: ${reason}`,
+            originalInput: operation,
+            suggestions,
+            recoverable: safeAlternative !== undefined,
+            timestamp: new Date().toISOString(),
+        });
+    }
+}
+/**
+ * Blocked operation error - explicitly forbidden by policy
+ */
+export class BlockedOperationError extends StructuredError {
+    constructor(operation, policy, allowedAlternatives) {
+        const suggestions = [];
+        if (allowedAlternatives && allowedAlternatives.length > 0) {
+            for (const alt of allowedAlternatives) {
+                suggestions.push({
+                    action: `Try allowed alternative: ${alt}`,
+                    example: alt,
+                    autoFixable: true,
+                    autoFix: () => alt,
+                });
+            }
+        }
+        else {
+            suggestions.push({
+                action: 'This operation is not permitted by policy',
+                autoFixable: false,
+            });
+        }
+        super({
+            severity: ErrorSeverity.ERROR,
+            category: ErrorCategory.BLOCKED,
+            message: `Operation blocked by policy "${policy}": ${operation}`,
+            originalInput: operation,
+            suggestions,
+            recoverable: allowedAlternatives !== undefined && allowedAlternatives.length > 0,
+            timestamp: new Date().toISOString(),
+            metadata: { policy, allowedAlternatives },
+        });
+    }
+}
+/**
+ * Context overflow error - token/character limits exceeded
+ */
+export class ContextOverflowError extends StructuredError {
+    constructor(actual, limit, unit = 'tokens', truncatable = true) {
+        const percentage = limit > 0 ? Math.round((actual / limit) * 100) : 0;
+        const suggestions = [];
+        if (truncatable) {
+            suggestions.push({
+                action: `Auto-truncate to ${limit} ${unit}`,
+                example: `Content will be reduced from ${actual} to ${limit} ${unit}`,
+                autoFixable: true,
+                autoFix: () => ({ truncate: true, limit }),
+            });
+        }
+        suggestions.push({
+            action: `Reduce scope to use less than ${limit} ${unit}`,
+            autoFixable: false,
+        });
+        super({
+            severity: ErrorSeverity.CRITICAL,
+            category: ErrorCategory.CONTEXT_OVERFLOW,
+            message: `Context overflow: ${actual} ${unit} exceeds limit of ${limit} ${unit} (${percentage}%)`,
+            suggestions,
+            recoverable: truncatable,
+            timestamp: new Date().toISOString(),
+            metadata: { actual, limit, unit, percentage },
+        });
+    }
+}
+/**
+ * Resource error - limits exceeded
+ */
+export class ResourceLimitError extends StructuredError {
+    constructor(resource, actual, limit, reducible = true) {
+        const suggestions = [];
+        if (reducible) {
+            const safeValue = Math.floor(limit * 0.8); // 80% of limit
+            suggestions.push({
+                action: `Reduce ${resource} to ${safeValue} (80% of limit)`,
+                example: `Set ${resource}=${safeValue}`,
+                autoFixable: true,
+                autoFix: () => safeValue,
+            });
+        }
+        super({
+            severity: ErrorSeverity.ERROR,
+            category: ErrorCategory.RESOURCE,
+            message: `Resource limit exceeded: ${resource} is ${actual}, maximum is ${limit}`,
+            suggestions,
+            recoverable: reducible,
+            timestamp: new Date().toISOString(),
+            metadata: { resource, actual, limit },
+        });
+    }
+}
+/**
+ * Validation error - input/schema validation failed
+ */
+export class ValidationError extends StructuredError {
+    constructor(field, code, message) {
+        super({
+            severity: ErrorSeverity.ERROR,
+            category: ErrorCategory.VALIDATION,
+            message: `Validation failed for ${field}: ${code}. ${message}`,
+            originalInput: code,
+            suggestions: [
+                {
+                    action: `Fix the field "${field}" to satisfy validation`,
+                    example: `${field}: <provide valid value>`,
+                    autoFixable: false,
+                },
+            ],
+            recoverable: false,
+            timestamp: new Date().toISOString(),
+            metadata: { field, code },
+        });
+    }
+}
+/**
+ * Format any error as a structured error
+ */
+export function toStructuredError(error) {
+    // Already structured
+    if (error instanceof StructuredError) {
+        return error;
+    }
+    // Convert standard errors
+    const message = error instanceof Error ? error.message : String(error);
+    // Detect error category from message
+    const category = detectErrorCategory(message);
+    const severity = detectErrorSeverity(category);
+    class GenericStructuredError extends StructuredError {
+    }
+    return new GenericStructuredError({
+        severity,
+        category,
+        message,
+        suggestions: [],
+        recoverable: false,
+        timestamp: new Date().toISOString(),
+    });
+}
+/**
+ * Detect error category from error message
+ */
+function detectErrorCategory(message) {
+    const lower = message.toLowerCase();
+    if (lower.includes('dangerous') || lower.includes('unsafe') || lower.includes('harmful')) {
+        return ErrorCategory.DANGEROUS;
+    }
+    if (lower.includes('blocked') || lower.includes('forbidden') || lower.includes('not allowed')) {
+        return ErrorCategory.BLOCKED;
+    }
+    if (lower.includes('invalid') || lower.includes('malformed')) {
+        return ErrorCategory.INVALID;
+    }
+    if (lower.includes('permission') || lower.includes('unauthorized') || lower.includes('access denied')) {
+        return ErrorCategory.PERMISSION;
+    }
+    if (lower.includes('limit') || lower.includes('exceeded') || lower.includes('too large')) {
+        return ErrorCategory.RESOURCE;
+    }
+    if (lower.includes('timeout') || lower.includes('timed out')) {
+        return ErrorCategory.TIMEOUT;
+    }
+    if (lower.includes('network') || lower.includes('connection')) {
+        return ErrorCategory.NETWORK;
+    }
+    if (lower.includes('validation') || lower.includes('schema')) {
+        return ErrorCategory.VALIDATION;
+    }
+    if (lower.includes('context') || lower.includes('token') || lower.includes('overflow')) {
+        return ErrorCategory.CONTEXT_OVERFLOW;
+    }
+    if (lower.includes('not found') || lower.includes('does not exist')) {
+        return ErrorCategory.NOT_FOUND;
+    }
+    return ErrorCategory.UNKNOWN;
+}
+/**
+ * Determine severity from category
+ */
+function detectErrorSeverity(category) {
+    switch (category) {
+        case ErrorCategory.DANGEROUS:
+        case ErrorCategory.CONTEXT_OVERFLOW:
+            return ErrorSeverity.CRITICAL;
+        case ErrorCategory.BLOCKED:
+        case ErrorCategory.PERMISSION:
+        case ErrorCategory.VALIDATION:
+        case ErrorCategory.INVALID:
+        case ErrorCategory.RESOURCE:
+            return ErrorSeverity.ERROR;
+        case ErrorCategory.TIMEOUT:
+        case ErrorCategory.NETWORK:
+        case ErrorCategory.NOT_FOUND:
+            return ErrorSeverity.WARNING;
+        default:
+            return ErrorSeverity.ERROR;
+    }
+}
+//# sourceMappingURL=errorTypes.js.map

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

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

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

@@ -0,0 +1,50 @@
+/**
+ * Unified Error Handling System
+ *
+ * This module consolidates all error-related exports into a single entry point.
+ * Use this module for all error handling needs instead of importing from
+ * individual files.
+ *
+ * Architecture:
+ * - errorTypes.ts: Base classes and structured error types
+ * - apiKeyErrors.ts: API key and authentication errors
+ * - networkErrors.ts: Network connectivity errors
+ * - safetyValidator.ts: Input validation and safety checks
+ *
+ * Usage:
+ * ```typescript
+ * import {
+ *   StructuredError,
+ *   ErrorSeverity,
+ *   ErrorCategory,
+ *   DangerousOperationError,
+ *   detectApiKeyError,
+ *   detectNetworkError,
+ * } from '../core/errors/index.js';
+ * ```
+ */
+export { ErrorSeverity, ErrorCategory, type ErrorSuggestion, type StructuredErrorDetails, StructuredError, DangerousOperationError, BlockedOperationError, ContextOverflowError, ResourceLimitError, ValidationError, toStructuredError, } from './errorTypes.js';
+export { type ApiKeyErrorType, type ApiKeyErrorInfo, detectApiKeyError, } from './apiKeyErrors.js';
+export { type NetworkErrorInfo, detectNetworkError, } from './networkErrors.js';
+export * from './safetyValidator.js';
+export { type ErrorContextValue, type ErrorContext, buildError, } from '../errors.js';
+/**
+ * Detect and classify any error into a structured format
+ */
+export declare function detectError(error: unknown, provider?: string): {
+    type: 'api_key' | 'network' | 'structured' | 'unknown';
+    info: unknown;
+};
+/**
+ * Check if an error is recoverable
+ */
+export declare function isRecoverableError(error: unknown): boolean;
+/**
+ * Get a user-friendly error message
+ */
+export declare function getUserFriendlyMessage(error: unknown): string;
+/**
+ * Format error for logging (includes full details)
+ */
+export declare function formatForLogging(error: unknown, context?: Record<string, unknown>): string;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/errors/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAMH,OAAO,EAEL,aAAa,EACb,aAAa,EAGb,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAG3B,eAAe,EAGf,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,EAGf,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAMzB,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAM3B,OAAO,EACL,KAAK,gBAAgB,EACrB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAM5B,cAAc,sBAAsB,CAAC;AAMrC,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,UAAU,GACX,MAAM,cAAc,CAAC;AAatB;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG;IAC9D,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,CAAC;IACvD,IAAI,EAAE,OAAO,CAAC;CACf,CA0BA;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAa1D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAuB7D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CA2B1F"}