@iflow-mcp/attio-mcp 1.3.6

package/dist/utils/error-detection.js

@@ -0,0 +1,157 @@
+/**
+ * Explicit error detection utilities for MCP responses
+ *
+ * Provides precise error detection logic to avoid false positives
+ * from string-based heuristics and empty/false responses that
+ * are actually valid success states.
+ */
+/**
+ * Compute error status with explicit detection logic only
+ *
+ * Avoids false positives by only flagging:
+ * - Null/undefined results
+ * - Explicit success: false
+ * - Meaningful error objects with messages
+ * - Non-empty error strings
+ * - Error arrays with actual error items
+ *
+ * @param result - Result object to analyze
+ * @param opts - Optional context for tool-specific logic
+ * @returns Error analysis with explicit reasoning
+ */
+export function computeErrorWithContext(result, opts) {
+    const toolName = opts?.toolName;
+    const isPlainObject = result && typeof result === 'object' && !Array.isArray(result);
+    const isEmptyObject = isPlainObject &&
+        Object.keys(result).length === 0;
+    // 1) Always surface explicit API errors first
+    const apiResponse = result;
+    if (apiResponse?.error ||
+        (Array.isArray(apiResponse?.errors) && apiResponse.errors.length)) {
+        return { isError: true, reason: 'meaningful_error_object' };
+    }
+    // Handle arrays (bulk ops, list endpoints, etc.)
+    if (Array.isArray(result)) {
+        // explicit errors inside any element
+        const hasExplicitErr = result.some((r) => r?.error || (Array.isArray(r?.errors) && r.errors.length));
+        if (hasExplicitErr)
+            return { isError: true, reason: 'api_error_array' };
+        // empty arrays are usually a failure for create/bulk flows
+        if (result.length === 0)
+            return { isError: true, reason: 'empty_array' };
+        return { isError: false };
+    }
+    // 2) Create-record special case:
+    //    On 2xx paths the transport may hand minimal shells through;
+    //    don't classify {} as an error here — let the business layer
+    //    (extractor/assert) decide shape.
+    if (toolName === 'create-record') {
+        if (result == null)
+            return { isError: true, reason: 'null_or_undefined_result' };
+        if (isEmptyObject)
+            return { isError: false };
+    }
+    // 3) Legacy heuristics (unchanged for other tools)
+    if (result == null)
+        return { isError: true, reason: 'null_or_undefined_result' };
+    if (isEmptyObject)
+        return { isError: true, reason: 'empty_response' };
+    // Detect empty objects as errors (per Issue #517 analysis)
+    // Empty objects {} often indicate failed API responses that should be errors
+    // Detect Attio API "unknown" record responses (indicates record not found)
+    // Attio sometimes returns fake records with id.record_id: 'unknown' instead of 404s
+    if (result && typeof result === 'object' && !Array.isArray(result)) {
+        const record = result;
+        if (record.id &&
+            typeof record.id === 'object' &&
+            !Array.isArray(record.id)) {
+            const id = record.id;
+            if (id.record_id === 'unknown') {
+                return { isError: true, reason: 'empty_response' };
+            }
+        }
+    }
+    // Check for explicit success: false
+    if (typeof result === 'object' && result !== null && 'success' in result) {
+        const successField = result.success;
+        if (successField === false) {
+            return { isError: true, reason: 'explicit_success_false' };
+        }
+    }
+    // Check for meaningful error objects
+    if (typeof result === 'object' && result !== null && 'error' in result) {
+        const errorField = result.error;
+        // Error object with message
+        if (errorField &&
+            typeof errorField === 'object' &&
+            'message' in errorField) {
+            const message = errorField.message;
+            if (typeof message === 'string' && message.trim()) {
+                return { isError: true, reason: 'meaningful_error_object' };
+            }
+        }
+        // Error string (non-empty)
+        if (typeof errorField === 'string' && errorField.trim().length > 0) {
+            return { isError: true, reason: 'meaningful_error_string' };
+        }
+    }
+    // Check for errors array with meaningful items
+    if (typeof result === 'object' && result !== null && 'errors' in result) {
+        const errorsField = result.errors;
+        if (Array.isArray(errorsField)) {
+            const hasErrors = errorsField.some((err) => {
+                if (!err)
+                    return false;
+                // Error with message
+                if (typeof err === 'object' && 'message' in err) {
+                    const message = err.message;
+                    return typeof message === 'string' && message.trim();
+                }
+                // Error with code
+                if (typeof err === 'object' && 'code' in err) {
+                    return true;
+                }
+                // Non-empty error string
+                if (typeof err === 'string') {
+                    return err.trim().length > 0;
+                }
+                return false;
+            });
+            if (hasErrors) {
+                return { isError: true, reason: 'errors_array_has_items' };
+            }
+        }
+    }
+    // Default to no error for all other cases
+    // This includes:
+    // - Empty arrays: []
+    // - Empty strings: ""
+    // - false/null values in data fields
+    // - Missing fields
+    // - Zero counts
+    return { isError: false };
+}
+/**
+ * Check if a result should have empty error fields removed
+ *
+ * @param result - Result to clean
+ * @returns Cleaned result without empty error indicators
+ */
+export function cleanEmptyErrorFields(result) {
+    if (!result || typeof result !== 'object') {
+        return result;
+    }
+    const cleaned = { ...result };
+    // Remove empty error field
+    if ('error' in cleaned && (cleaned.error === '' || cleaned.error === null)) {
+        delete cleaned.error;
+    }
+    // Remove empty errors array
+    if ('errors' in cleaned &&
+        Array.isArray(cleaned.errors) &&
+        cleaned.errors.length === 0) {
+        delete cleaned.errors;
+    }
+    return cleaned;
+}
+//# sourceMappingURL=error-detection.js.map

package/dist/utils/error-detection.js.map

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

package/dist/utils/error-enhancer.d.ts

@@ -0,0 +1,24 @@
+import type { UnknownObject } from './types/common.js';
+/**
+ * Enhance an API error with value suggestions if applicable
+ */
+export declare function enhanceApiError(error: UnknownObject): Error;
+/**
+ * Check if an error is a value mismatch that we can enhance
+ */
+export declare function isValueMismatchError(error: UnknownObject): {
+    isMismatch: boolean;
+    fieldSlug?: string;
+    searchValue?: string;
+    errorMessage?: string;
+};
+/**
+ * Get valid values for a field (if known)
+ */
+export declare function getKnownFieldValues(fieldSlug: string): string[] | null;
+/**
+ * Add or update known field values
+ * This could be populated from Attio API discovery
+ */
+export declare function updateKnownFieldValues(fieldSlug: string, values: string[]): void;
+//# sourceMappingURL=error-enhancer.d.ts.map

package/dist/utils/error-enhancer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-enhancer.d.ts","sourceRoot":"","sources":["../../src/utils/error-enhancer.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAwJvD;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,KAAK,CAqD3D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,aAAa,GAAG;IAC1D,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAkCA;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAEtE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EAAE,GACf,IAAI,CAEN"}

package/dist/utils/error-enhancer.js

@@ -0,0 +1,204 @@
+/**
+ * Enhances API errors with helpful suggestions for value mismatches
+ */
+import { ValueMatchError } from '../errors/value-match-error.js';
+import { findBestValueMatch, } from './value-matcher.js';
+import axios from 'axios';
+import { createScopedLogger } from './logger.js';
+// Known valid values for select fields - this should ideally come from Attio API
+const KNOWN_FIELD_VALUES = {
+    // Note: type_persona removed as it doesn't exist in Attio API
+    // Custom fields should be discovered via CLI or auto-discovery
+    categories: [
+        'B2B',
+        'B2C',
+        'SaaS',
+        'Healthcare',
+        'Technology',
+        'Finance',
+        'Education',
+        'Retail',
+        'Manufacturing',
+        'Hospitality',
+        'Real Estate',
+        'Professional Services',
+    ],
+    stage: [
+        'Lead',
+        'Prospect',
+        'Opportunity',
+        'Customer',
+        'Churned',
+        'Qualified',
+        'Engaged',
+        'Negotiation',
+    ],
+};
+/**
+ * Parse API error to extract context
+ */
+function parseApiError(error) {
+    // Use imported createScopedLogger
+    const log = createScopedLogger('utils.error-enhancer', 'parseApiError');
+    log.debug('ENTERING parseApiError');
+    log.debug('Error type info', {
+        type: typeof error,
+        ctor: error?.constructor?.name,
+    });
+    if (error && typeof error === 'object') {
+        log.debug('Error keys', { keys: Object.keys(error) });
+        log.debug('Error message from input', { message: error.message });
+    }
+    const isAxios = axios.isAxiosError(error);
+    log.debug('axios.isAxiosError result', { isAxios });
+    let responseExists = false;
+    let responseDataExists = false;
+    let responseDataContent = 'N/A';
+    if (isAxios && error.response) {
+        responseExists = true;
+        log.debug('Response exists. Keys', { keys: Object.keys(error.response) });
+        if (error.response.data) {
+            responseDataExists = true;
+            try {
+                responseDataContent = JSON.stringify(error.response.data);
+            }
+            catch {
+                // Failed to stringify response data
+                responseDataContent = 'Error stringifying response.data';
+            }
+            log.debug('Response data exists', {
+                type: typeof error.response.data,
+                content: responseDataContent,
+            });
+        }
+        else {
+            log.debug('Response data is falsy');
+        }
+    }
+    else {
+        log.debug('Response is falsy or not an Axios error for this check');
+        log.debug('Response data is falsy (no response)');
+    }
+    log.debug('Final check before condition', {
+        isAxios,
+        responseExists,
+        responseDataExists,
+    });
+    if (isAxios &&
+        responseExists &&
+        responseDataExists &&
+        error.response &&
+        error.response.data) {
+        // Use imported createScopedLogger
+        const log = createScopedLogger('utils.error-enhancer', 'parseApiError');
+        log.debug('Condition met: processing error.response.data');
+        const data = error.response.data;
+        const message = typeof data.message === 'string' ? data.message : '';
+        const pathArray = Array.isArray(data.path) && data.path.length > 0 ? data.path : [];
+        const path = typeof pathArray[0] === 'string' ? pathArray[0] : undefined;
+        log.debug('Extracted from response.data', { message, path });
+        if (message.includes('Unknown select option name') ||
+            message.includes('Unknown multi-select option names')) {
+            const valueMatch = message.match(/constraint: (.*)/);
+            const extractedValue = valueMatch && typeof valueMatch[1] === 'string'
+                ? valueMatch[1].split(',')[0].trim()
+                : undefined;
+            console.error(`[enhancer-parseApiError] --- RETURNING ValueMismatch context: field='${path}', value='${extractedValue}' ---`);
+            return {
+                fieldSlug: path,
+                searchValue: extractedValue,
+                errorMessage: message,
+            };
+        }
+        createScopedLogger('utils.error-enhancer', 'parseApiError').debug('Returning Non-ValueMismatch Axios context', { field: path });
+        return { fieldSlug: path, errorMessage: message };
+    }
+    createScopedLogger('utils.error-enhancer', 'parseApiError').debug('Condition not met');
+    const genericErrorMessage = error && typeof error.message === 'string'
+        ? error.message
+        : 'Unknown error';
+    createScopedLogger('utils.error-enhancer', 'parseApiError').debug('Returning generic message', { genericErrorMessage });
+    return { errorMessage: genericErrorMessage };
+}
+/**
+ * Enhance an API error with value suggestions if applicable
+ */
+export function enhanceApiError(error) {
+    // Use imported createScopedLogger
+    const log = createScopedLogger('utils.error-enhancer', 'enhanceApiError');
+    log.debug('Called with error', {
+        type: error?.constructor?.name,
+        isAxiosError: !!error?.isAxiosError,
+    });
+    log.debug('Attempting to enhance error', {
+        message: error?.message,
+        responseData: error?.response?.data,
+    });
+    const mismatchCheck = isValueMismatchError(error);
+    log.debug('Mismatch check result', mismatchCheck);
+    if (mismatchCheck.isMismatch &&
+        mismatchCheck.fieldSlug &&
+        mismatchCheck.searchValue) {
+        const fieldSlug = mismatchCheck.fieldSlug;
+        const searchValue = mismatchCheck.searchValue;
+        const knownValues = KNOWN_FIELD_VALUES[fieldSlug]; // Already checked in isValueMismatchError, but good for clarity
+        log.debug('Value mismatch confirmed', { fieldSlug, searchValue });
+        if (knownValues) {
+            log.debug('Attempting to find best match', { fieldSlug, searchValue });
+            const matchResult = findBestValueMatch(searchValue, knownValues);
+            log.debug('Match result from findBestValueMatch', matchResult);
+            log.debug('Returning NEW ValueMatchError');
+            return new ValueMatchError(fieldSlug, searchValue, matchResult, error // Pass original Axios error for reference
+            );
+        }
+    }
+    else {
+        log.debug('No actionable mismatch', {
+            errorMessage: mismatchCheck.errorMessage,
+        });
+    }
+    log.debug('No specific enhancement applied; returning original error');
+    return error; // Fallback: return original error if not enhanced
+}
+/**
+ * Check if an error is a value mismatch that we can enhance
+ */
+export function isValueMismatchError(error) {
+    const context = parseApiError(error);
+    createScopedLogger('utils.error-enhancer', 'isValueMismatchError').debug('Context from parseApiError', context);
+    if (context.fieldSlug &&
+        context.searchValue &&
+        KNOWN_FIELD_VALUES[context.fieldSlug]) {
+        const knownValues = KNOWN_FIELD_VALUES[context.fieldSlug];
+        if (knownValues &&
+            !knownValues.some((v) => v.toLowerCase() === context.searchValue?.toLowerCase())) {
+            createScopedLogger('utils.error-enhancer', 'isValueMismatchError').debug('Mismatch found', { fieldSlug: context.fieldSlug, searchValue: context.searchValue });
+            return {
+                isMismatch: true,
+                fieldSlug: context.fieldSlug,
+                searchValue: context.searchValue,
+                errorMessage: context.errorMessage,
+            };
+        }
+    }
+    createScopedLogger('utils.error-enhancer', 'isValueMismatchError').debug('No mismatch or field/value not in KNOWN_FIELD_VALUES');
+    return { isMismatch: false, errorMessage: context.errorMessage };
+}
+/**
+ * Get valid values for a field (if known)
+ */
+export function getKnownFieldValues(fieldSlug) {
+    return KNOWN_FIELD_VALUES[fieldSlug] || null;
+}
+/**
+ * Add or update known field values
+ * This could be populated from Attio API discovery
+ */
+export function updateKnownFieldValues(fieldSlug, values) {
+    KNOWN_FIELD_VALUES[fieldSlug] = values;
+}
+// Remove locally defined ValueMatchResult and similarity functions if they were causing issues
+// interface ValueMatchResult { ... }
+// function similarity(...) { ... }
+// function editDistance(...) { ... }
+//# sourceMappingURL=error-enhancer.js.map

package/dist/utils/error-enhancer.js.map

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

package/dist/utils/error-examples.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Error examples utility
+ *
+ * Provides helpful examples for common error scenarios to enhance error messages
+ */
+import { ErrorType } from './error-handler.js';
+import { UnknownObject } from './types/common.js';
+interface ErrorExample {
+    description: string;
+    example: UnknownObject;
+    tip?: string;
+}
+/**
+ * Get helpful examples based on error context
+ */
+export declare function getErrorExamples(errorType: ErrorType, context: {
+    toolName?: string;
+    paramName?: string;
+    expectedType?: string;
+    actualValue?: unknown;
+    path?: string;
+}): ErrorExample[];
+/**
+ * Enhance an error message with helpful examples and field suggestions
+ */
+export declare function enhanceErrorMessage(originalMessage: string, errorType: ErrorType, context: {
+    toolName?: string;
+    paramName?: string;
+    expectedType?: string;
+    actualValue?: unknown;
+    path?: string;
+    fieldName?: string;
+    validFields?: string[];
+    validValues?: string[];
+    resourceType?: string;
+    isReadOnly?: boolean;
+    operation?: 'create' | 'update';
+}): string;
+export {};
+//# sourceMappingURL=error-examples.d.ts.map

package/dist/utils/error-examples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-examples.d.ts","sourceRoot":"","sources":["../../src/utils/error-examples.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAQ/C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,UAAU,YAAY;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,aAAa,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE;IACP,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GACA,YAAY,EAAE,CAuGhB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE;IACP,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;CACjC,GACA,MAAM,CA+ER"}

package/dist/utils/error-examples.js

@@ -0,0 +1,163 @@
+/**
+ * Error examples utility
+ *
+ * Provides helpful examples for common error scenarios to enhance error messages
+ */
+import { ErrorType } from './error-handler.js';
+import { generateFieldSuggestionMessage, generateEnumSuggestionMessage, generateReadOnlyFieldMessage, generateResourceTypeSuggestionMessage, VALID_RESOURCE_TYPES, } from './field-suggestions.js';
+/**
+ * Get helpful examples based on error context
+ */
+export function getErrorExamples(errorType, context) {
+    const examples = [];
+    switch (errorType) {
+        case ErrorType.PARAMETER_ERROR:
+            if (context.paramName === 'filters') {
+                examples.push({
+                    description: 'Correct filters format',
+                    example: {
+                        filters: {
+                            filters: [
+                                {
+                                    attribute: { slug: 'name' },
+                                    condition: 'contains',
+                                    value: 'Company Inc',
+                                },
+                            ],
+                        },
+                    },
+                    tip: 'The filters parameter must contain a "filters" property with an array of filter conditions',
+                });
+            }
+            else if (context.paramName === 'updates' ||
+                context.paramName === 'attributes') {
+                examples.push({
+                    description: 'Correct attributes format',
+                    example: {
+                        name: 'New Company Name',
+                        lead_score: 90,
+                        team_size: 50,
+                        website: 'https://example.com',
+                    },
+                    tip: 'Provide a flat object with field names as keys and values as the new values',
+                });
+            }
+            else if (context.paramName?.includes('Id')) {
+                examples.push({
+                    description: 'Correct ID format',
+                    example: {
+                        [context.paramName]: 'rec_1234567890abcdef',
+                    },
+                    tip: 'IDs should be the full record ID from Attio, not a numeric value',
+                });
+            }
+            break;
+        case ErrorType.VALIDATION_ERROR:
+            if (context.expectedType === 'number' &&
+                typeof context.actualValue === 'string') {
+                examples.push({
+                    description: 'String values for numeric fields are automatically converted',
+                    example: {
+                        lead_score: '90', // Will be converted to 90
+                        team_size: '50', // Will be converted to 50
+                    },
+                    tip: 'You can provide numeric values as strings - they will be converted automatically',
+                });
+            }
+            else if (context.expectedType === 'boolean') {
+                examples.push({
+                    description: 'Boolean field formats',
+                    example: {
+                        is_customer: true,
+                        active: 'true', // String 'true' is accepted
+                        verified: 1, // 1 is accepted as true
+                    },
+                    tip: 'Boolean fields accept: true/false, "true"/"false", 1/0',
+                });
+            }
+            break;
+        case ErrorType.FORMAT_ERROR:
+            if (context.toolName?.includes('note')) {
+                examples.push({
+                    description: 'Create note requires both title and content',
+                    example: {
+                        title: 'Meeting Notes',
+                        content: 'Discussed Q4 strategy and budget planning',
+                    },
+                    tip: 'Both title and content are required when creating notes',
+                });
+            }
+            break;
+        default:
+            // Generic helpful examples
+            if (context.toolName?.includes('update')) {
+                examples.push({
+                    description: 'Update operations accept multiple parameter names',
+                    example: {
+                        // Option 1: Resource-specific ID
+                        companyId: 'rec_1234567890abcdef',
+                        // Option 2: Generic recordId
+                        recordId: 'rec_1234567890abcdef',
+                    },
+                    tip: 'You can use either resource-specific IDs (companyId, personId) or the generic recordId',
+                });
+            }
+    }
+    return examples;
+}
+/**
+ * Enhance an error message with helpful examples and field suggestions
+ */
+export function enhanceErrorMessage(originalMessage, errorType, context) {
+    let enhancedMessage = originalMessage;
+    // Apply field name suggestions if we have validation errors
+    if (errorType === ErrorType.VALIDATION_ERROR ||
+        errorType === ErrorType.PARAMETER_ERROR) {
+        // Check for invalid field name scenarios
+        if (context.fieldName &&
+            context.validFields &&
+            context.validFields.length > 0) {
+            if (!context.validFields.includes(context.fieldName)) {
+                enhancedMessage = generateFieldSuggestionMessage(context.fieldName, context.validFields, context.resourceType);
+            }
+            else if (context.isReadOnly) {
+                enhancedMessage = generateReadOnlyFieldMessage(context.fieldName, context.operation);
+            }
+        }
+        // Check for invalid enum values
+        if (context.fieldName &&
+            context.validValues &&
+            context.validValues.length > 0) {
+            if (context.actualValue !== undefined && context.actualValue !== null) {
+                const valueStr = String(context.actualValue);
+                if (!context.validValues.includes(valueStr)) {
+                    // Only pass primitive values to generateEnumSuggestionMessage
+                    const primitiveValue = typeof context.actualValue === 'string' ||
+                        typeof context.actualValue === 'number' ||
+                        typeof context.actualValue === 'boolean'
+                        ? context.actualValue
+                        : valueStr;
+                    enhancedMessage = generateEnumSuggestionMessage(primitiveValue, context.validValues, context.fieldName);
+                }
+            }
+        }
+        // Check for invalid resource types
+        if (context.resourceType &&
+            !VALID_RESOURCE_TYPES.includes(context.resourceType)) {
+            enhancedMessage = generateResourceTypeSuggestionMessage(context.resourceType, VALID_RESOURCE_TYPES);
+        }
+    }
+    // Add examples to the enhanced message
+    const examples = getErrorExamples(errorType, context);
+    if (examples.length > 0) {
+        examples.forEach((example) => {
+            enhancedMessage += `\n\n${example.description}:`;
+            enhancedMessage += `\n${JSON.stringify(example.example, null, 2)}`;
+            if (example.tip) {
+                enhancedMessage += `\n\nTIP: ${example.tip}`;
+            }
+        });
+    }
+    return enhancedMessage;
+}
+//# sourceMappingURL=error-examples.js.map

package/dist/utils/error-examples.js.map

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