@trenchwork/coder 1.3.0

package/dist/core/errorClassification.js

@@ -0,0 +1,333 @@
+/**
+ * Canonical home for provider error classification (audit Rank 5, Phase 1).
+ *
+ * Behaviour-PRESERVING extraction: each call site's predicate + pattern set is
+ * moved here VERBATIM under a site-specific name — NOT merged into a superset.
+ * A superset would change which errors each provider retries or falls back on,
+ * a behaviour change the audit Do-NOT list forbids ("don't ship a behaviour
+ * change dressed as a refactor"). The providers import these and re-export under
+ * their existing public names, so importers + tests are untouched. agent.ts's
+ * classifier is a THIRD semantics (rate-limit + 5xx folded into "transient") and
+ * is deliberately NOT folded in here yet (deferred per the roadmap).
+ *
+ * test/error-classification.test.ts pins every predicate against a battery of
+ * real error shapes captured from the pre-extraction code, so any drift is red.
+ */
+// ════════════════════════════════════════════════════════════════════════════
+// resilientProvider classifiers — LIVE (the fallback path in agentController +
+// the retry loop in withProviderResilience). Patterns + logic verbatim.
+// ════════════════════════════════════════════════════════════════════════════
+export const RESILIENT_RATE_LIMIT_PATTERNS = [
+    'rate limit',
+    'rate_limit',
+    'ratelimit',
+    'too many requests',
+    '429',
+    'quota exceeded',
+    'request limit',
+    'throttled',
+    'overloaded',
+    'capacity',
+];
+export const RESILIENT_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',
+];
+export const FALLBACK_ELIGIBLE_PATTERNS = [
+    // Quota/billing errors
+    'insufficient_quota',
+    'quota exceeded',
+    'exceeded your current quota',
+    'billing',
+    'payment required',
+    'account suspended',
+    'account disabled',
+    // API key errors
+    'api key expired',
+    'api_key_invalid',
+    'invalid api key',
+    'invalid_api_key',
+    'api key not valid',
+    // Model availability errors
+    'model not found',
+    'model_not_found',
+    'does not exist',
+    'not available',
+    'deprecated',
+    'access denied',
+    'permission denied',
+    'unauthorized',
+    '401',
+    '403',
+    '400',
+    'invalid_argument',
+    // Regional/access restrictions
+    'region',
+    'not supported in your',
+    'country',
+    'restricted',
+];
+/**
+ * Check if an error warrants trying a different provider (fallback).
+ * These are non-transient errors that won't be fixed by retrying the same provider.
+ */
+export function isFallbackEligibleError(error) {
+    if (!(error instanceof Error))
+        return false;
+    const message = error.message.toLowerCase();
+    // Check message for fallback patterns
+    if (FALLBACK_ELIGIBLE_PATTERNS.some(pattern => message.includes(pattern))) {
+        return true;
+    }
+    // Check error code/type/reason if present (OpenAI and Google style errors).
+    // The TypeScript types here are aspirational — provider SDKs throw errors
+    // with `.status` as a number (HTTP code) or `.code`/`.type` as objects, so
+    // every lookup must be coerced through String() before .toLowerCase() or
+    // the whole error path crashes with `(...).toLowerCase is not a function`.
+    // Bug seen in 1.1.7: a DeepSeek error's numeric `.status` killed the
+    // submission flow on the first prompt of a fresh session.
+    const errorWithCode = error;
+    const code = String(errorWithCode.code ?? '').toLowerCase();
+    const type = String(errorWithCode.type ?? '').toLowerCase();
+    const reason = String(errorWithCode.reason ?? '').toLowerCase();
+    const status = String(errorWithCode.status ?? '').toLowerCase();
+    // OpenAI style errors
+    if (code === 'insufficient_quota' || type === 'insufficient_quota') {
+        return true;
+    }
+    if (code === 'model_not_found' || type === 'model_not_found') {
+        return true;
+    }
+    if (code === 'invalid_api_key' || type === 'invalid_api_key') {
+        return true;
+    }
+    // Google style errors
+    if (reason === 'api_key_invalid' || status === 'invalid_argument') {
+        return true;
+    }
+    if (code === '400' || code === '401' || code === '403') {
+        return true;
+    }
+    return false;
+}
+/**
+ * Get a user-friendly description of why fallback is needed
+ */
+export function getFallbackReason(error) {
+    if (!(error instanceof Error))
+        return 'Unknown error';
+    const message = error.message.toLowerCase();
+    if (message.includes('quota') || message.includes('billing')) {
+        return 'API quota exceeded or billing issue';
+    }
+    if (message.includes('expired') || message.includes('api_key_invalid') || message.includes('api key')) {
+        return 'API key expired or invalid';
+    }
+    if (message.includes('model') && (message.includes('not found') || message.includes('not exist'))) {
+        return 'Model not available';
+    }
+    if (message.includes('unauthorized') || message.includes('401') || message.includes('invalid_api_key')) {
+        return 'Invalid API key';
+    }
+    if (message.includes('403') || message.includes('permission') || message.includes('access denied')) {
+        return 'Access denied';
+    }
+    if (message.includes('400') || message.includes('invalid_argument')) {
+        return 'Invalid request or API key';
+    }
+    if (message.includes('region') || message.includes('country') || message.includes('restricted')) {
+        return 'Regional restriction';
+    }
+    return 'Provider error';
+}
+export function isResilientRateLimitError(error) {
+    if (!(error instanceof Error))
+        return false;
+    const message = error.message.toLowerCase();
+    return RESILIENT_RATE_LIMIT_PATTERNS.some(pattern => message.includes(pattern));
+}
+export function isResilientTransientError(error) {
+    if (!(error instanceof Error))
+        return false;
+    // Check message
+    const message = error.message.toLowerCase();
+    if (RESILIENT_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 && RESILIENT_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 isResilientTransientError(cause);
+    }
+    return false;
+}
+export function shouldRetryResilient(error) {
+    return isResilientRateLimitError(error) || isResilientTransientError(error);
+}
+// ════════════════════════════════════════════════════════════════════════════
+// baseProvider classifiers — kept DISTINCT from the resilient set (e.g. base
+// has no enotfound/ssl). Currently consumed only by tests + baseProvider's own
+// withRetry default. Patterns + logic verbatim.
+// ════════════════════════════════════════════════════════════════════════════
+/** Patterns that indicate transient/retryable errors */
+export const BASE_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',
+];
+/** Check if an error is transient and can be retried */
+export function isBaseTransientError(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 BASE_TRANSIENT_ERROR_PATTERNS.some((pattern) => allText.includes(pattern));
+}
+/** Check if an error is a rate limit error */
+export function isBaseRateLimitError(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'));
+}
+// ════════════════════════════════════════════════════════════════════════════
+// agent.ts classifiers — a THIRD semantics: isAgentTransientError folds rate
+// limits + 5xx + "server error" INTO "transient" (the agent retries all of them
+// the same way), unlike the base/resilient split. Kept distinct. Verbatim.
+// ════════════════════════════════════════════════════════════════════════════
+/** Check if an error is a context overflow error */
+export function isContextOverflowError(error) {
+    if (!(error instanceof Error))
+        return false;
+    const message = error.message.toLowerCase();
+    return (message.includes('context length') ||
+        message.includes('token') && (message.includes('limit') || message.includes('exceed') || message.includes('maximum')) ||
+        message.includes('too long') ||
+        message.includes('too many tokens') ||
+        message.includes('max_tokens') ||
+        message.includes('context window'));
+}
+/** Check if an error is transient/retryable from the agent loop's perspective
+ *  (network issues, rate limits, AND server errors all fold into "transient"). */
+export function isAgentTransientError(error) {
+    if (!(error instanceof Error))
+        return false;
+    const message = error.message.toLowerCase();
+    // Network errors (including streaming-specific termination patterns from undici/node-fetch)
+    const networkPatterns = [
+        'econnrefused', 'econnreset', 'enotfound', 'etimedout', 'epipe',
+        'network error', 'connection error', 'fetch failed', 'socket hang up',
+        'network is unreachable', 'connection refused', 'connection reset',
+        // Streaming-specific: server closes connection mid-stream
+        'premature close', 'premature end', 'unexpected end',
+        'aborted', 'fetcherror', 'invalid response body',
+    ];
+    if (networkPatterns.some(p => message.includes(p))) {
+        return true;
+    }
+    // Rate limit errors
+    if (message.includes('rate limit') || message.includes('429') || message.includes('too many requests')) {
+        return true;
+    }
+    // Server errors (5xx)
+    if (message.includes('500') || message.includes('502') || message.includes('503') || message.includes('504')) {
+        return true;
+    }
+    // Temporary service errors
+    if (message.includes('service unavailable') || message.includes('temporarily unavailable') ||
+        message.includes('overloaded') || message.includes('server error')) {
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=errorClassification.js.map

package/dist/core/errorClassification.js.map

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

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

@@ -0,0 +1,11 @@
+import type { ProviderId } from '../types.js';
+import { type SecretDefinition } from '../secretStore.js';
+export type ApiKeyErrorType = 'missing' | 'invalid';
+export interface ApiKeyErrorInfo {
+    type: ApiKeyErrorType;
+    provider: ProviderId | null;
+    secret?: SecretDefinition | null;
+    message?: string;
+}
+export declare function detectApiKeyError(error: unknown, provider?: ProviderId | null): ApiKeyErrorInfo | null;
+//# sourceMappingURL=apiKeyErrors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"apiKeyErrors.d.ts","sourceRoot":"","sources":["../../../src/core/errors/apiKeyErrors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAEL,KAAK,gBAAgB,EAEtB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,SAAS,CAAC;AAEpD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,eAAe,CAAC;IACtB,QAAQ,EAAE,UAAU,GAAG,IAAI,CAAC;IAC5B,MAAM,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,UAAU,GAAG,IAAI,GAAG,eAAe,GAAG,IAAI,CAuBtG"}

package/dist/core/errors/apiKeyErrors.js

@@ -0,0 +1,159 @@
+import { MissingSecretError, getSecretDefinitionForProvider, } from '../secretStore.js';
+export function detectApiKeyError(error, provider) {
+    if (error instanceof MissingSecretError) {
+        const primaryProvider = error.secret.providers[0] ?? null;
+        return {
+            type: 'missing',
+            provider: provider ?? primaryProvider,
+            secret: error.secret,
+            message: error.message,
+        };
+    }
+    if (isUnauthorizedError(error)) {
+        const labelProvider = provider ?? extractProviderFromError(error);
+        const secret = labelProvider ? getSecretDefinitionForProvider(labelProvider) : null;
+        return {
+            type: 'invalid',
+            provider: labelProvider,
+            secret,
+            message: extractErrorMessage(error),
+        };
+    }
+    return null;
+}
+function isUnauthorizedError(error) {
+    const status = extractStatus(error);
+    if (status === 401 || status === 403) {
+        return true;
+    }
+    const payload = extractStructuredError(error);
+    if (payload) {
+        // Check type and code fields
+        const normalizedType = normalize(payload.type) || normalize(payload.code);
+        if (normalizedType && containsAuthKeyword(normalizedType)) {
+            return true;
+        }
+        // Check status field (e.g., "PERMISSION_DENIED")
+        if (payload.status && containsAuthKeyword(normalize(payload.status))) {
+            return true;
+        }
+        // Check reason field (e.g., "forbidden")
+        if (payload.reason && containsAuthKeyword(normalize(payload.reason))) {
+            return true;
+        }
+        // Check message field
+        if (payload.message && containsAuthKeyword(normalize(payload.message))) {
+            return true;
+        }
+    }
+    const message = normalize(extractErrorMessage(error));
+    if (!message) {
+        return false;
+    }
+    return containsAuthKeyword(message);
+}
+function extractStatus(error) {
+    if (!error || typeof error !== 'object') {
+        return null;
+    }
+    const directStatus = error.status;
+    if (typeof directStatus === 'number') {
+        return directStatus;
+    }
+    const response = error.response;
+    if (response && typeof response.status === 'number') {
+        return response.status;
+    }
+    return null;
+}
+function extractStructuredError(error) {
+    if (!error || typeof error !== 'object') {
+        return null;
+    }
+    // Handle nested error.error structure (common in Google/Gemini errors)
+    if ('error' in error) {
+        const candidate = error.error;
+        if (candidate && typeof candidate === 'object') {
+            const structured = candidate;
+            // Extract reason from nested errors array (Gemini format)
+            let reason = structured.reason;
+            if (!reason && structured.errors && Array.isArray(structured.errors) && structured.errors[0]?.reason) {
+                reason = structured.errors[0].reason;
+            }
+            return {
+                type: structured.type,
+                code: typeof structured.code === 'number' ? String(structured.code) : structured.code,
+                message: structured.message,
+                status: structured.status,
+                reason,
+            };
+        }
+    }
+    // Handle direct status/reason on error object
+    const directError = error;
+    if (directError.status || directError.reason || directError.code) {
+        return {
+            status: directError.status,
+            reason: directError.reason,
+            code: typeof directError.code === 'number' ? String(directError.code) : directError.code,
+            message: directError.message,
+        };
+    }
+    return null;
+}
+function extractProviderFromError(error) {
+    if (!error || typeof error !== 'object') {
+        return null;
+    }
+    const provider = error.provider;
+    if (typeof provider === 'string' && provider.trim()) {
+        return provider.trim();
+    }
+    return null;
+}
+function extractErrorMessage(error) {
+    if (typeof error === 'string') {
+        return error;
+    }
+    if (error instanceof Error) {
+        return error.message ?? '';
+    }
+    if (error && typeof error === 'object') {
+        const payload = extractStructuredError(error);
+        if (payload?.message) {
+            return payload.message;
+        }
+        if ('message' in error && typeof error.message === 'string') {
+            return error.message;
+        }
+    }
+    return '';
+}
+function containsAuthKeyword(value) {
+    if (!value) {
+        return false;
+    }
+    return (value.includes('api key') ||
+        value.includes('apikey') ||
+        value.includes('api-key') ||
+        value.includes('authentication') ||
+        value.includes('unauthorized') ||
+        value.includes('permission_denied') ||
+        value.includes('permission denied') ||
+        value.includes('forbidden') ||
+        value.includes('invalid_api_key') ||
+        value.includes('invalid api key') ||
+        value.includes('access_denied') ||
+        value.includes('access denied') ||
+        value.includes('not authorized') ||
+        value.includes('credentials') ||
+        value.includes('entitlement') ||
+        value.includes('subscription'));
+}
+function normalize(value) {
+    if (!value || typeof value !== 'string') {
+        return null;
+    }
+    return value.toLowerCase();
+}
+//# sourceMappingURL=apiKeyErrors.js.map

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

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

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