attio-mcp 0.1.2 → 1.1.0

package/dist/errors/api-errors.js

@@ -2,6 +2,7 @@
  * Error class hierarchy for Attio API errors
  * Includes specialized error types for API interactions and validation
  */
+import { sanitizeErrorMessage } from '../utils/error-sanitizer.js';
 /**
  * Base class for all Attio API errors
  */
@@ -32,8 +33,14 @@ export class AttioApiError extends Error {
      * Get a formatted representation of the error for logging
      */
     toFormattedString() {
+        // In production, sanitize the output
+        if (process.env.NODE_ENV === 'production') {
+            return `${this.name} (${this.statusCode}): ${sanitizeErrorMessage(this.message)}`;
+        }
+        // In development, include more details but still sanitize sensitive data
+        const sanitizedEndpoint = this.endpoint.replace(/\/[a-f0-9-]{20,}/gi, '/[ID_REDACTED]');
         return (`${this.name} (${this.statusCode}): ${this.message}\n` +
-            `Endpoint: ${this.method} ${this.endpoint}\n` +
+            `Endpoint: ${this.method} ${sanitizedEndpoint}\n` +
             `Details: ${JSON.stringify(this.details || {}, null, 2)}`);
     }
 }
@@ -41,8 +48,10 @@ export class AttioApiError extends Error {
  * Error for authentication issues (401)
  */
 export class AuthenticationError extends AttioApiError {
-    constructor(message = 'Authentication failed. Please check your API key.', endpoint, method, details) {
-        super(message, 401, endpoint, method, details);
+    constructor(message = 'Authentication failed. Please check your credentials.', endpoint, method, details) {
+        // Sanitize the message to avoid exposing API key format
+        const sanitizedMessage = message.replace(/api[_-]?key[\s:=]*["']?[a-zA-Z0-9_-]{20,}["']?/gi, '[CREDENTIAL_REDACTED]');
+        super(sanitizedMessage, 401, endpoint, method, details);
         this.name = 'AuthenticationError';
         // This line is needed to properly capture the stack trace
         Object.setPrototypeOf(this, AuthenticationError.prototype);
@@ -52,8 +61,10 @@ export class AuthenticationError extends AttioApiError {
  * Error for authorization issues (403)
  */
 export class AuthorizationError extends AttioApiError {
-    constructor(message = 'Authorization failed. Your API key lacks the necessary permissions.', endpoint, method, details) {
-        super(message, 403, endpoint, method, details);
+    constructor(message = 'Authorization failed. You lack the necessary permissions.', endpoint, method, details) {
+        // Sanitize the message to avoid exposing permission details
+        const sanitizedMessage = message.replace(/permission[s]?[\s:]+["']?[a-z_.]+["']?/gi, '[PERMISSION_REDACTED]');
+        super(sanitizedMessage, 403, endpoint, method, details);
         this.name = 'AuthorizationError';
         // This line is needed to properly capture the stack trace
         Object.setPrototypeOf(this, AuthorizationError.prototype);
@@ -64,7 +75,9 @@ export class AuthorizationError extends AttioApiError {
  */
 export class ResourceNotFoundError extends AttioApiError {
     constructor(resourceType, resourceId, endpoint, method, details) {
-        super(`${resourceType} with ID '${resourceId}' not found`, 404, endpoint, method, details);
+        // Sanitize resource ID to avoid exposing internal identifiers
+        const sanitizedId = resourceId.length > 10 ? '[ID_REDACTED]' : resourceId;
+        super(`${resourceType} ${sanitizedId} not found`, 404, endpoint, method, details);
         this.name = 'ResourceNotFoundError';
         // This line is needed to properly capture the stack trace
         Object.setPrototypeOf(this, ResourceNotFoundError.prototype);
@@ -103,6 +116,63 @@ export class ServerError extends AttioApiError {
         Object.setPrototypeOf(this, ServerError.prototype);
     }
 }
+/**
+ * Error for network connectivity issues (timeout, connection refused, DNS issues)
+ */
+export class NetworkError extends Error {
+    endpoint;
+    method;
+    cause;
+    constructor(message, endpoint, method, cause) {
+        super(message);
+        this.endpoint = endpoint;
+        this.method = method;
+        this.cause = cause;
+        this.name = 'NetworkError';
+        // This line is needed to properly capture the stack trace
+        Object.setPrototypeOf(this, NetworkError.prototype);
+    }
+    /**
+     * Check if an error is a network-related error
+     */
+    static isNetworkError(error) {
+        if (error instanceof NetworkError)
+            return true;
+        // Check for error codes that indicate network issues
+        const errorObj = error;
+        if (errorObj.code) {
+            const networkCodes = [
+                'ECONNREFUSED',
+                'ENOTFOUND',
+                'ECONNRESET',
+                'ETIMEDOUT',
+                'ECONNABORTED',
+                'EHOSTUNREACH',
+                'ENETUNREACH',
+            ];
+            if (networkCodes.includes(errorObj.code))
+                return true;
+        }
+        // Check for specific network-related messages
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        const networkKeywords = [
+            'Network Error',
+            'fetch failed',
+            'connection refused',
+            'dns lookup failed',
+            'timeout',
+        ];
+        // Only match if the message starts with or contains these specific patterns
+        return networkKeywords.some((keyword) => errorMessage.toLowerCase().includes(keyword.toLowerCase()));
+    }
+    /**
+     * Create a NetworkError from a caught error
+     */
+    static fromError(error, endpoint, method) {
+        const originalError = error instanceof Error ? error : new Error(String(error));
+        return new NetworkError(`Network error occurred: ${originalError.message}`, endpoint, method, originalError);
+    }
+}
 /**
  * Factory function to create the appropriate error type based on status code
  *
@@ -144,14 +214,27 @@ export function createApiErrorFromStatus(statusCode, message, endpoint, method,
  * @returns The appropriate error instance
  */
 export function createApiErrorFromAxiosError(error, endpoint, method) {
-    const statusCode = error.response?.status || 500;
-    const message = error.response?.data?.message || error.message || 'Unknown API error';
-    const details = error.response?.data || {};
+    const axiosError = error;
+    // Check if this is a network error first (no response = network issue)
+    if (!axiosError.response) {
+        // No response means network connectivity issue
+        if (NetworkError.isNetworkError(error)) {
+            return NetworkError.fromError(error, endpoint, method);
+        }
+        // If no response but not a recognized network error, treat as generic API error
+        const message = axiosError.message || 'Unknown API error';
+        return new AttioApiError(message, 500, endpoint, method, {});
+    }
+    const statusCode = axiosError.response.status || 500;
+    const message = axiosError.response?.data?.message ||
+        axiosError.message ||
+        'Unknown API error';
+    const details = axiosError.response?.data || {};
     // Special case for ResourceNotFoundError with object types
     if (statusCode === 404 && endpoint.includes('/objects/')) {
         // Extract resource type and ID from endpoint
         // Assuming endpoint format like /objects/{type}/records/{id}
-        const matches = endpoint.match(/\/objects\/([^\/]+)\/records\/([^\/]+)/);
+        const matches = endpoint.match(/\/objects\/([^/]+)\/records\/([^/]+)/);
         if (matches && matches.length >= 3) {
             const [, resourceType, resourceId] = matches;
             // Format resource type properly: 'people' -> 'Person', 'companies' -> 'Company'
@@ -199,7 +282,7 @@ export var FilterErrorCategory;
  *       FilterErrorCategory.CONDITION
  *     );
  *   }
- * } catch (error) {
+ * } catch (error: unknown) {
  *   if (error instanceof FilterValidationError) {
  *     // Handle filter validation error based on category
  *     if (error.category === FilterErrorCategory.CONDITION) {
@@ -238,10 +321,10 @@ export class FilterValidationError extends Error {
  *       'companies'
  *     );
  *   }
- * } catch (error) {
+ * } catch (error: unknown) {
  *   if (error instanceof RelationshipFilterError) {
  *     // Handle relationship filter error
- *     console.log(`Relationship error between ${error.sourceType} and ${error.targetType}`);
+ *     console.error(`Relationship error between ${error.sourceType} and ${error.targetType}`);
  *   }
  * }
  * ```
@@ -278,7 +361,7 @@ export class RelationshipFilterError extends FilterValidationError {
  *   if (!isValidListId(listId)) {
  *     throw new ListRelationshipError(`Invalid list ID: ${listId}`, 'people', listId);
  *   }
- * } catch (error) {
+ * } catch (error: unknown) {
  *   if (error instanceof ListRelationshipError) {
  *     // Handle list relationship error
  *   }

package/dist/errors/api-errors.js.map

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

package/dist/errors/company-errors.d.ts

@@ -1,40 +1,53 @@
 /**
  * Domain-specific error classes for company operations
  */
+import { BaseWrappedError } from './BaseWrappedError.js';
 /**
  * Base error class for company-related errors
  */
-export declare class CompanyError extends Error {
-    constructor(message: string);
+export declare class CompanyError extends BaseWrappedError {
+    constructor(message: string, opts?: {
+        cause?: unknown;
+    });
 }
 /**
  * Error thrown when a company is not found
  */
 export declare class CompanyNotFoundError extends CompanyError {
-    constructor(companyId: string);
+    constructor(companyId: string, opts?: {
+        cause?: unknown;
+    });
 }
 /**
  * Error thrown when company data is invalid
  */
 export declare class InvalidCompanyDataError extends CompanyError {
-    constructor(message: string);
+    constructor(message: string, opts?: {
+        cause?: unknown;
+    });
 }
 /**
  * Error thrown when a company operation fails
  */
 export declare class CompanyOperationError extends CompanyError {
-    constructor(operation: string, companyId?: string, details?: string);
+    constructor(operation: string, companyId?: string, details?: string, opts?: {
+        cause?: unknown;
+    });
 }
 /**
  * Error thrown when a required company field is missing
  */
 export declare class MissingCompanyFieldError extends InvalidCompanyDataError {
-    constructor(fieldName: string);
+    constructor(fieldName: string, opts?: {
+        cause?: unknown;
+    });
 }
 /**
  * Error thrown when a company field has an invalid type
  */
 export declare class InvalidCompanyFieldTypeError extends InvalidCompanyDataError {
-    constructor(fieldName: string, expectedType: string, actualType: string);
+    constructor(fieldName: string, expectedType: string, actualType: string, opts?: {
+        cause?: unknown;
+    });
 }
 //# sourceMappingURL=company-errors.d.ts.map

package/dist/errors/company-errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"company-errors.d.ts","sourceRoot":"","sources":["../../src/errors/company-errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,YAAY;gBACxC,SAAS,EAAE,MAAM;CAI9B;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,YAAY;gBAC3C,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,YAAY;gBACzC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAUpE;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,uBAAuB;gBACvD,SAAS,EAAE,MAAM;CAI9B;AAED;;GAEG;AACH,qBAAa,4BAA6B,SAAQ,uBAAuB;gBAC3D,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAMxE"}
+{"version":3,"file":"company-errors.d.ts","sourceRoot":"","sources":["../../src/errors/company-errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD;;GAEG;AACH,qBAAa,YAAa,SAAQ,gBAAgB;gBACpC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAGxD;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,YAAY;gBACxC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAI1D;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,YAAY;gBAC3C,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAIxD;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,YAAY;gBAEnD,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAW7B;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,uBAAuB;gBACvD,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAI1D;AAED;;GAEG;AACH,qBAAa,4BAA6B,SAAQ,uBAAuB;gBAErE,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAQ7B"}

package/dist/errors/company-errors.js

@@ -1,21 +1,21 @@
 /**
  * Domain-specific error classes for company operations
  */
+import { BaseWrappedError } from './BaseWrappedError.js';
 /**
  * Base error class for company-related errors
  */
-export class CompanyError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'CompanyError';
+export class CompanyError extends BaseWrappedError {
+    constructor(message, opts) {
+        super('CompanyError', message, opts);
     }
 }
 /**
  * Error thrown when a company is not found
  */
 export class CompanyNotFoundError extends CompanyError {
-    constructor(companyId) {
-        super(`Company with ID ${companyId} not found`);
+    constructor(companyId, opts) {
+        super(`Company with ID ${companyId} not found`, opts);
         this.name = 'CompanyNotFoundError';
     }
 }
@@ -23,8 +23,8 @@ export class CompanyNotFoundError extends CompanyError {
  * Error thrown when company data is invalid
  */
 export class InvalidCompanyDataError extends CompanyError {
-    constructor(message) {
-        super(`Invalid company data: ${message}`);
+    constructor(message, opts) {
+        super(`Invalid company data: ${message}`, opts);
         this.name = 'InvalidCompanyDataError';
     }
 }
@@ -32,12 +32,12 @@ export class InvalidCompanyDataError extends CompanyError {
  * Error thrown when a company operation fails
  */
 export class CompanyOperationError extends CompanyError {
-    constructor(operation, companyId, details) {
+    constructor(operation, companyId, details, opts) {
         const baseMessage = `Company ${operation} failed`;
         const fullMessage = companyId
             ? `${baseMessage} for company ${companyId}${details ? `: ${details}` : ''}`
             : `${baseMessage}${details ? `: ${details}` : ''}`;
-        super(fullMessage);
+        super(fullMessage, opts);
         this.name = 'CompanyOperationError';
     }
 }
@@ -45,8 +45,8 @@ export class CompanyOperationError extends CompanyError {
  * Error thrown when a required company field is missing
  */
 export class MissingCompanyFieldError extends InvalidCompanyDataError {
-    constructor(fieldName) {
-        super(`Required field '${fieldName}' is missing`);
+    constructor(fieldName, opts) {
+        super(`Required field '${fieldName}' is missing`, opts);
         this.name = 'MissingCompanyFieldError';
     }
 }
@@ -54,8 +54,8 @@ export class MissingCompanyFieldError extends InvalidCompanyDataError {
  * Error thrown when a company field has an invalid type
  */
 export class InvalidCompanyFieldTypeError extends InvalidCompanyDataError {
-    constructor(fieldName, expectedType, actualType) {
-        super(`Field '${fieldName}' must be of type ${expectedType}, but got ${actualType}`);
+    constructor(fieldName, expectedType, actualType, opts) {
+        super(`Field '${fieldName}' must be of type ${expectedType}, but got ${actualType}`, opts);
         this.name = 'InvalidCompanyFieldTypeError';
     }
 }

package/dist/errors/company-errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"company-errors.js","sourceRoot":"","sources":["../../src/errors/company-errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,YAAY;IACpD,YAAY,SAAiB;QAC3B,KAAK,CAAC,mBAAmB,SAAS,YAAY,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,uBAAwB,SAAQ,YAAY;IACvD,YAAY,OAAe;QACzB,KAAK,CAAC,yBAAyB,OAAO,EAAE,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,qBAAsB,SAAQ,YAAY;IACrD,YAAY,SAAiB,EAAE,SAAkB,EAAE,OAAgB;QACjE,MAAM,WAAW,GAAG,WAAW,SAAS,SAAS,CAAC;QAClD,MAAM,WAAW,GAAG,SAAS;YAC3B,CAAC,CAAC,GAAG,WAAW,gBAAgB,SAAS,GACrC,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC,CAAC,EAC7B,EAAE;YACJ,CAAC,CAAC,GAAG,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACrD,KAAK,CAAC,WAAW,CAAC,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,wBAAyB,SAAQ,uBAAuB;IACnE,YAAY,SAAiB;QAC3B,KAAK,CAAC,mBAAmB,SAAS,cAAc,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,4BAA6B,SAAQ,uBAAuB;IACvE,YAAY,SAAiB,EAAE,YAAoB,EAAE,UAAkB;QACrE,KAAK,CACH,UAAU,SAAS,qBAAqB,YAAY,aAAa,UAAU,EAAE,CAC9E,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;IAC7C,CAAC;CACF"}
+{"version":3,"file":"company-errors.js","sourceRoot":"","sources":["../../src/errors/company-errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,gBAAgB;IAChD,YAAY,OAAe,EAAE,IAA0B;QACrD,KAAK,CAAC,cAAc,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACvC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,YAAY;IACpD,YAAY,SAAiB,EAAE,IAA0B;QACvD,KAAK,CAAC,mBAAmB,SAAS,YAAY,EAAE,IAAI,CAAC,CAAC;QACtD,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,uBAAwB,SAAQ,YAAY;IACvD,YAAY,OAAe,EAAE,IAA0B;QACrD,KAAK,CAAC,yBAAyB,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,qBAAsB,SAAQ,YAAY;IACrD,YACE,SAAiB,EACjB,SAAkB,EAClB,OAAgB,EAChB,IAA0B;QAE1B,MAAM,WAAW,GAAG,WAAW,SAAS,SAAS,CAAC;QAClD,MAAM,WAAW,GAAG,SAAS;YAC3B,CAAC,CAAC,GAAG,WAAW,gBAAgB,SAAS,GACrC,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC,CAAC,EAC7B,EAAE;YACJ,CAAC,CAAC,GAAG,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACrD,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,wBAAyB,SAAQ,uBAAuB;IACnE,YAAY,SAAiB,EAAE,IAA0B;QACvD,KAAK,CAAC,mBAAmB,SAAS,cAAc,EAAE,IAAI,CAAC,CAAC;QACxD,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,4BAA6B,SAAQ,uBAAuB;IACvE,YACE,SAAiB,EACjB,YAAoB,EACpB,UAAkB,EAClB,IAA0B;QAE1B,KAAK,CACH,UAAU,SAAS,qBAAqB,YAAY,aAAa,UAAU,EAAE,EAC7E,IAAI,CACL,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;IAC7C,CAAC;CACF"}

package/dist/errors/enhanced-api-errors.d.ts

@@ -0,0 +1,186 @@
+/**
+ * Enhanced API Error System for Consolidated Issues #415, #416, #417
+ *
+ * This module provides comprehensive error messaging with contextual information
+ * to address:
+ * - Issue #415: Poor error message quality and user experience
+ * - Issue #416: Misleading "Invalid format" vs "Not found" confusion
+ * - Issue #417: Task-specific error guidance and field mapping help
+ */
+import { AttioApiError } from './api-errors.js';
+import type { AttributeMetadata } from '../services/utils/attribute-metadata.js';
+/**
+ * Enhanced error context interface providing rich information for better UX
+ */
+export interface EnhancedApiErrorContext {
+    /** Field name that caused the error */
+    field?: string;
+    /** Type information for the problematic field */
+    fieldType?: string;
+    /**
+     * Attio field configuration snapshot for deep diagnostics.
+     * @remarks Commonly includes api_slug, field_type, title, and config.select options.
+     */
+    fieldMetadata?: AttributeMetadata;
+    /** Valid values for select fields */
+    validValues?: string[];
+    /** Suggested field names for typos */
+    suggestedFields?: string[];
+    /** Resource type being operated on */
+    resourceType?: string;
+    /** Operation being performed (create, update, get, etc.) */
+    operation?: string;
+    /** Whether the field is read-only */
+    isReadOnly?: boolean;
+    /** Documentation hint or command suggestion */
+    documentationHint?: string;
+    /** Record ID for "not found" vs "invalid format" distinction */
+    recordId?: string;
+    /** HTTP status code for precise error categorization */
+    httpStatus?: number;
+    /** Whether this error is retryable */
+    retryable?: boolean;
+    /** Original error for debugging */
+    originalError?: Error;
+    /** Server response data for debugging */
+    serverData?: Record<string, unknown>;
+}
+/** @deprecated Use EnhancedApiErrorContext instead */
+export type ErrorContext = EnhancedApiErrorContext;
+/**
+ * Enhanced API Error class that provides contextual error messages
+ *
+ * This class extends the base AttioApiError with rich context information
+ * to provide actionable error messages that guide users toward solutions.
+ */
+export declare class EnhancedApiError extends AttioApiError {
+    readonly context?: EnhancedApiErrorContext | undefined;
+    constructor(message: string, statusCode: number, endpoint: string, method: string, context?: EnhancedApiErrorContext | undefined);
+    /**
+     * Check if this is a user error (400-level)
+     */
+    isUserError(): boolean;
+    /**
+     * Get error category for classification
+     */
+    getErrorCategory(): 'user' | 'system' | 'network' | 'auth' | 'unknown';
+    /**
+     * Generate a contextual error message with actionable guidance
+     *
+     * This method analyzes the error context and constructs helpful messages
+     * that address the specific issues identified in the consolidated issues.
+     */
+    getContextualMessage(): string;
+    /**
+     * Generate "Record not found" error message for Issue #416
+     */
+    private getNotFoundErrorMessage;
+    /**
+     * Generate field suggestions for typos
+     */
+    private getFieldSuggestions;
+    /**
+     * Generate task-specific error guidance for Issue #417
+     */
+    private getTaskErrorMessage;
+    /**
+     * Generate field validation error messages for Issue #415
+     */
+    private getFieldValidationMessage;
+    /**
+     * Generate general guidance messages
+     */
+    private getGeneralGuidanceMessage;
+    /**
+     * Generate task-specific error guidance
+     *
+     * Addresses Issue #417 by providing clear guidance for task field mappings
+     * and common task-related errors.
+     */
+    private getTaskSpecificGuidance;
+    /**
+     * Check if this error is likely retryable
+     */
+    isRetryable(): boolean;
+}
+/**
+ * Factory function to create enhanced API errors with proper context
+ */
+export declare function createEnhancedApiError(message: string, statusCode: number, endpoint: string, method: string, context?: Partial<EnhancedApiErrorContext>): EnhancedApiError;
+/**
+ * Enhanced error templates for common scenarios
+ *
+ * These templates provide consistent, helpful error messages across the application
+ */
+export declare const ErrorTemplates: {
+    /**
+     * Issue #415: Invalid select option template
+     */
+    INVALID_SELECT_OPTION: (field: string, value: string, validOptions: string[], resourceType?: string) => EnhancedApiError;
+    /**
+     * Issue #415: Read-only field template
+     */
+    READ_ONLY_FIELD: (field: string, resourceType: string) => EnhancedApiError;
+    /**
+     * Issue #415: Unknown field template
+     */
+    UNKNOWN_FIELD: (field: string, suggestions: string[], resourceType: string) => EnhancedApiError;
+    /**
+     * Issue #416: Record not found template (vs invalid format)
+     */
+    RECORD_NOT_FOUND: (recordId: string, resourceType: string) => EnhancedApiError;
+    /**
+     * Issue #416: Invalid UUID format template (vs not found)
+     */
+    INVALID_UUID_FORMAT: (recordId: string, resourceType: string) => EnhancedApiError;
+    /**
+     * Issue #417: Task field mapping template
+     */
+    TASK_FIELD_MAPPING: (originalField: string, correctField: string) => EnhancedApiError;
+    /**
+     * Issue #798: Phone number format error template
+     */
+    PHONE_NUMBER_FORMAT_ERROR: (field: string, resourceType: string) => EnhancedApiError;
+    /**
+     * Generic enhanced error template
+     */
+    GENERIC: (message: string, statusCode: number, endpoint: string, method: string, context?: Partial<EnhancedApiErrorContext>) => EnhancedApiError;
+};
+/**
+ * Error enhancement utilities
+ */
+export declare class ErrorEnhancer {
+    /**
+     * Enhance a standard API error with context
+     */
+    static enhance(error: Error | AttioApiError, context?: Partial<EnhancedApiErrorContext>): EnhancedApiError;
+    /**
+     * Issue #425: Safe error message extraction utility
+     * Extracts a contextual message from any error type safely
+     * Handles: EnhancedApiError, AttioApiError, UniversalValidationError, and generic errors
+     */
+    static getErrorMessage(error: Error | EnhancedApiError | AttioApiError | {
+        message?: string;
+    } | unknown): string;
+    /**
+     * Issue #425: Convert any error to EnhancedApiError
+     * Ensures all errors are properly enhanced for consistent handling
+     */
+    static ensureEnhanced(error: Error | EnhancedApiError | AttioApiError | {
+        message?: string;
+        statusCode?: number;
+        status?: number;
+        endpoint?: string;
+        path?: string;
+        method?: string;
+    } | unknown, defaultContext?: Partial<EnhancedApiErrorContext>): EnhancedApiError;
+    /**
+     * Auto-detect error type and apply appropriate enhancement
+     */
+    static autoEnhance(error: Error, resourceType?: string, operation?: string, recordId?: string): EnhancedApiError;
+    /**
+     * Get correct task field mapping
+     */
+    private static getTaskFieldMapping;
+}
+//# sourceMappingURL=enhanced-api-errors.d.ts.map

package/dist/errors/enhanced-api-errors.d.ts.map

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