deepseek-coder-agent-cli 1.0.0

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"}

package/dist/core/errors/index.js

@@ -0,0 +1,156 @@
+/**
+ * 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';
+ * ```
+ */
+// ═══════════════════════════════════════════════════════════════════════════════
+// Error Types and Base Classes
+// ═══════════════════════════════════════════════════════════════════════════════
+export { 
+// Enums
+ErrorSeverity, ErrorCategory, 
+// Base class
+StructuredError, 
+// Specific error classes
+DangerousOperationError, BlockedOperationError, ContextOverflowError, ResourceLimitError, ValidationError, 
+// Factory functions
+toStructuredError, } from './errorTypes.js';
+// ═══════════════════════════════════════════════════════════════════════════════
+// API Key Errors
+// ═══════════════════════════════════════════════════════════════════════════════
+export { detectApiKeyError, } from './apiKeyErrors.js';
+// ═══════════════════════════════════════════════════════════════════════════════
+// Network Errors
+// ═══════════════════════════════════════════════════════════════════════════════
+export { detectNetworkError, } from './networkErrors.js';
+// ═══════════════════════════════════════════════════════════════════════════════
+// Safety Validator
+// ═══════════════════════════════════════════════════════════════════════════════
+export * from './safetyValidator.js';
+// ═══════════════════════════════════════════════════════════════════════════════
+// Legacy Re-exports (from ../errors.ts)
+// ═══════════════════════════════════════════════════════════════════════════════
+export { buildError, } from '../errors.js';
+// ═══════════════════════════════════════════════════════════════════════════════
+// Utility Functions
+// ═══════════════════════════════════════════════════════════════════════════════
+import { StructuredError as StructuredErrorClass, } from './errorTypes.js';
+import { detectApiKeyError as detectApiKeyErrorFn } from './apiKeyErrors.js';
+import { detectNetworkError as detectNetworkErrorFn } from './networkErrors.js';
+/**
+ * Detect and classify any error into a structured format
+ */
+export function detectError(error, provider) {
+    // Check for API key errors first
+    const apiKeyError = detectApiKeyErrorFn(error, provider);
+    if (apiKeyError) {
+        return { type: 'api_key', info: apiKeyError };
+    }
+    // Check for network errors
+    const networkError = detectNetworkErrorFn(error);
+    if (networkError) {
+        return { type: 'network', info: networkError };
+    }
+    // Check if it's already a structured error
+    if (error instanceof StructuredErrorClass) {
+        return { type: 'structured', info: error };
+    }
+    // Unknown error
+    return {
+        type: 'unknown',
+        info: {
+            message: error instanceof Error ? error.message : String(error),
+            stack: error instanceof Error ? error.stack : undefined,
+        },
+    };
+}
+/**
+ * Check if an error is recoverable
+ */
+export function isRecoverableError(error) {
+    // Structured errors have a recoverable flag
+    if (error instanceof StructuredErrorClass) {
+        return error.recoverable;
+    }
+    // Network errors are generally retryable
+    const networkError = detectNetworkErrorFn(error);
+    if (networkError) {
+        return networkError.retryable;
+    }
+    return false;
+}
+/**
+ * Get a user-friendly error message
+ */
+export function getUserFriendlyMessage(error) {
+    // Structured errors have their own display format
+    if (error instanceof StructuredErrorClass) {
+        return error.toDisplayString();
+    }
+    // API key errors
+    const apiKeyError = detectApiKeyErrorFn(error);
+    if (apiKeyError) {
+        if (apiKeyError.type === 'missing') {
+            return `Missing API key for ${apiKeyError.provider || 'provider'}. Please configure your API key.`;
+        }
+        return `Invalid API key for ${apiKeyError.provider || 'provider'}. Please check your API key configuration.`;
+    }
+    // Network errors
+    const networkError = detectNetworkErrorFn(error);
+    if (networkError) {
+        return `Network error: ${networkError.message}. Please check your internet connection and try again.`;
+    }
+    // Default
+    return error instanceof Error ? error.message : String(error);
+}
+/**
+ * Format error for logging (includes full details)
+ */
+export function formatForLogging(error, context) {
+    const timestamp = new Date().toISOString();
+    const parts = [`[${timestamp}]`];
+    if (error instanceof StructuredErrorClass) {
+        parts.push(`[${error.severity.toUpperCase()}]`);
+        parts.push(`[${error.category}]`);
+        parts.push(error.message);
+        if (error.metadata) {
+            parts.push(`Metadata: ${JSON.stringify(error.metadata)}`);
+        }
+    }
+    else if (error instanceof Error) {
+        parts.push(`[ERROR]`);
+        parts.push(error.message);
+        if (error.stack) {
+            parts.push(`Stack: ${error.stack}`);
+        }
+    }
+    else {
+        parts.push(`[ERROR]`);
+        parts.push(String(error));
+    }
+    if (context) {
+        parts.push(`Context: ${JSON.stringify(context)}`);
+    }
+    return parts.join(' ');
+}
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,14 @@
+import type { ProviderId } from '../types.js';
+export interface NetworkErrorInfo {
+    type: 'network';
+    message: string;
+    code?: string;
+    provider?: ProviderId | string;
+    retryable: boolean;
+}
+/**
+ * Heuristically detect network connectivity errors from provider/client failures.
+ * Covers DNS, TLS, socket, fetch, and generic "connection error" cases.
+ */
+export declare function detectNetworkError(error: unknown): NetworkErrorInfo | null;
+//# sourceMappingURL=networkErrors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"networkErrors.d.ts","sourceRoot":"","sources":["../../../src/core/errors/networkErrors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;IAC/B,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,GAAG,IAAI,CAwD1E"}

package/dist/core/errors/networkErrors.js

@@ -0,0 +1,53 @@
+/**
+ * Heuristically detect network connectivity errors from provider/client failures.
+ * Covers DNS, TLS, socket, fetch, and generic "connection error" cases.
+ */
+export function detectNetworkError(error) {
+    const toStringValue = (value) => typeof value === 'string' ? value : value instanceof Error ? value.message : '';
+    const code = typeof error?.code === 'string'
+        ? (error.code || '').toUpperCase()
+        : undefined;
+    const message = toStringValue(error).toLowerCase();
+    const causeCode = typeof error?.cause?.code === 'string'
+        ? error.cause.code.toUpperCase()
+        : undefined;
+    const text = `${code ?? ''} ${causeCode ?? ''} ${message}`;
+    const NETWORK_CODES = new Set([
+        'ECONNREFUSED',
+        'ECONNRESET',
+        'EAI_AGAIN',
+        'ENOTFOUND',
+        'EHOSTUNREACH',
+        'ENETUNREACH',
+        'ETIMEDOUT',
+        'EPIPE',
+    ]);
+    const NETWORK_PHRASES = [
+        'network error',
+        'connection error',
+        'failed to fetch',
+        'fetch failed',
+        'socket hang up',
+        'connect ECONNREFUSED',
+        'getaddrinfo ENOTFOUND',
+        'getaddrinfo EAI_AGAIN',
+        'tls handshake timeout',
+        'client network socket disconnected',
+        'self signed certificate',
+        'unexpected end of file',
+        'unable to verify the first certificate',
+        'network is unreachable',
+    ];
+    const isNetworkCode = (value) => Boolean(value && NETWORK_CODES.has(value));
+    const matchesPhrase = NETWORK_PHRASES.some((phrase) => text.includes(phrase));
+    if (!isNetworkCode(code) && !isNetworkCode(causeCode) && !matchesPhrase) {
+        return null;
+    }
+    return {
+        type: 'network',
+        message: toStringValue(error) || 'Network connectivity issue detected.',
+        code: code ?? causeCode,
+        retryable: true,
+    };
+}
+//# sourceMappingURL=networkErrors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"networkErrors.js","sourceRoot":"","sources":["../../../src/core/errors/networkErrors.ts"],"names":[],"mappings":"AAUA;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,MAAM,aAAa,GAAG,CAAC,KAAc,EAAU,EAAE,CAC/C,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAElF,MAAM,IAAI,GAAG,OAAQ,KAA4B,EAAE,IAAI,KAAK,QAAQ;QAClE,CAAC,CAAC,CAAE,KAA0B,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE;QACxD,CAAC,CAAC,SAAS,CAAC;IAEd,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IACnD,MAAM,SAAS,GAAG,OAAQ,KAAuC,EAAE,KAAK,EAAE,IAAI,KAAK,QAAQ;QACzF,CAAC,CAAE,KAAqC,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE;QACjE,CAAC,CAAC,SAAS,CAAC;IAEd,MAAM,IAAI,GAAG,GAAG,IAAI,IAAI,EAAE,IAAI,SAAS,IAAI,EAAE,IAAI,OAAO,EAAE,CAAC;IAE3D,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC;QAC5B,cAAc;QACd,YAAY;QACZ,WAAW;QACX,WAAW;QACX,cAAc;QACd,aAAa;QACb,WAAW;QACX,OAAO;KACR,CAAC,CAAC;IAEH,MAAM,eAAe,GAAG;QACtB,eAAe;QACf,kBAAkB;QAClB,iBAAiB;QACjB,cAAc;QACd,gBAAgB;QAChB,sBAAsB;QACtB,uBAAuB;QACvB,uBAAuB;QACvB,uBAAuB;QACvB,oCAAoC;QACpC,yBAAyB;QACzB,wBAAwB;QACxB,wCAAwC;QACxC,wBAAwB;KACzB,CAAC;IAEF,MAAM,aAAa,GAAG,CAAC,KAAc,EAAW,EAAE,CAAC,OAAO,CAAC,KAAK,IAAI,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9F,MAAM,aAAa,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAE9E,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;QACxE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,IAAI,sCAAsC;QACvE,IAAI,EAAE,IAAI,IAAI,SAAS;QACvB,SAAS,EAAE,IAAI;KAChB,CAAC;AACJ,CAAC"}