@iflow-mcp/attio-mcp 1.3.6

package/dist/services/update/FieldValidationHandler.js

@@ -0,0 +1,157 @@
+/**
+ * FieldValidationHandler - Validation orchestration with display name resolution
+ *
+ * Consolidates validation logic and integrates display name resolution
+ * for create/update operations.
+ *
+ * @see Issue #984 - Extend display name resolution to create/update operations
+ */
+import { validateFields } from '../../handlers/tool-configs/universal/field-mapper.js';
+import { ValidationService } from '../../services/ValidationService.js';
+import { debug, OperationType } from '../../utils/logger.js';
+/**
+ * FieldValidationHandler - Validation and display name resolution
+ */
+export class FieldValidationHandler {
+    /**
+     * Validate fields and optionally resolve display names to API slugs
+     *
+     * Integrates display name resolution (previously only in get_attribute_options)
+     * to work for create/update operations.
+     *
+     * @param resourceType - Resource type being validated
+     * @param values - Field values to validate
+     * @param objectSlug - Optional object slug for display name resolution
+     * @param enableDisplayNameResolution - Whether to attempt display name resolution (default: true)
+     * @returns Validation result with warnings, suggestions, and resolved field names
+     */
+    static async validateAndResolve(resourceType, values, objectSlug, enableDisplayNameResolution = true) {
+        const result = {
+            valid: true,
+            errors: [],
+            warnings: [],
+            suggestions: [],
+            resolvedFields: new Map(),
+        };
+        // Pre-validate fields with suggestions
+        const fieldValidation = validateFields(resourceType, values);
+        // Propagate validation results (PR #1006 Phase 3.1)
+        result.valid = fieldValidation.valid;
+        result.errors.push(...fieldValidation.errors);
+        if (fieldValidation.warnings.length > 0) {
+            result.warnings.push(...fieldValidation.warnings);
+            debug('FieldValidationHandler', 'Field validation warnings', {
+                resourceType,
+                warnings: fieldValidation.warnings.join('\n'),
+            });
+        }
+        if (fieldValidation.suggestions.length > 0) {
+            const truncated = ValidationService.truncateSuggestions(fieldValidation.suggestions);
+            result.suggestions.push(...truncated);
+            debug('FieldValidationHandler', 'Field suggestions', {
+                resourceType,
+                suggestions: truncated.join('\n'),
+            });
+        }
+        // NEW: Attempt display name resolution for unknown fields
+        if (enableDisplayNameResolution && objectSlug) {
+            await this.resolveDisplayNames(values, objectSlug, result);
+        }
+        return result;
+    }
+    /**
+     * Apply deal-specific validation and defaults
+     *
+     * @param values - Deal values to validate
+     * @param skipApiValidation - Whether to skip API validation
+     * @returns Deal validation result with validated data, warnings, and suggestions
+     */
+    static async validateDealDefaults(values, skipApiValidation = false) {
+        try {
+            const { applyDealDefaultsWithValidation } = await import('../../config/deal-defaults.js');
+            const dealValidation = await applyDealDefaultsWithValidation(values, skipApiValidation);
+            debug('FieldValidationHandler', 'Deal validation applied', {
+                warnings: dealValidation.warnings,
+                suggestions: dealValidation.suggestions,
+            });
+            return {
+                dealData: dealValidation.dealData,
+                warnings: dealValidation.warnings,
+                suggestions: dealValidation.suggestions,
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            debug('FieldValidationHandler', 'Deal validation failed', {
+                error: errorMessage,
+            });
+            return {
+                dealData: values,
+                warnings: [`Deal validation warning: ${errorMessage}`],
+                suggestions: [],
+            };
+        }
+    }
+    /**
+     * Attempt to resolve display names to API slugs for unknown fields
+     *
+     * This extends display name resolution (previously only in get_attribute_options)
+     * to work for create/update operations, improving UX consistency.
+     *
+     * @param values - Field values (may contain display names like "Deal stage")
+     * @param objectSlug - Object slug for attribute lookup
+     * @param result - Validation result to populate with resolutions
+     */
+    static async resolveDisplayNames(values, objectSlug, result) {
+        // Import display name resolver (will be exported in Phase 4)
+        // For now, we'll use a simplified version until shared-handlers exports it
+        try {
+            const fieldNames = Object.keys(values);
+            for (const fieldName of fieldNames) {
+                // Only attempt resolution for fields with spaces or mixed case (likely display names)
+                const mightBeDisplayName = fieldName.includes(' ') || /[A-Z]/.test(fieldName);
+                if (!mightBeDisplayName) {
+                    continue;
+                }
+                // Attempt to resolve display name to API slug
+                // Uses the exported resolveAttributeDisplayName from shared-handlers.ts
+                const resolved = await this.attemptDisplayNameResolution(objectSlug, fieldName);
+                if (resolved && resolved !== fieldName) {
+                    result.resolvedFields.set(fieldName, resolved);
+                    debug('FieldValidationHandler', 'Resolved display name', {
+                        from: fieldName,
+                        to: resolved,
+                        objectSlug,
+                    });
+                }
+            }
+        }
+        catch (error) {
+            // Silent fallback - display name resolution is best-effort
+            debug('FieldValidationHandler', 'Display name resolution failed', {
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    /**
+     * Attempt to resolve a display name to an API slug
+     *
+     * Uses the exported resolveAttributeDisplayName from shared-handlers.ts
+     * to support user-friendly field names like "Deal stage" instead of "stage"
+     *
+     * @param objectSlug - The object slug (e.g., "deals", "companies")
+     * @param fieldName - The field name to resolve (e.g., "Deal stage")
+     * @returns The resolved API slug if found, or null
+     */
+    static async attemptDisplayNameResolution(objectSlug, fieldName) {
+        try {
+            const { resolveAttributeDisplayName } = await import('../../handlers/tool-configs/universal/shared-handlers.js');
+            return await resolveAttributeDisplayName(objectSlug, fieldName);
+        }
+        catch (err) {
+            debug('FieldValidationHandler', 'Display name resolution failed', { objectSlug, fieldName, error: err }, 'attemptDisplayNameResolution', OperationType.DATA_PROCESSING);
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=FieldValidationHandler.js.map

package/dist/services/update/FieldValidationHandler.js.map

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

package/dist/services/update/MetadataResolver.d.ts

@@ -0,0 +1,50 @@
+/**
+ * MetadataResolver - Centralized metadata fetching with caching
+ *
+ * Consolidates duplicate metadata fetching from UniversalUpdateService
+ * and value-transformer into a single, cacheable operation.
+ *
+ * @see Issue #984 - Consolidate metadata fetching to reduce API calls by 40-60%
+ */
+import { UniversalResourceType } from '../../handlers/tool-configs/universal/types.js';
+import type { AttributeMetadata } from '../../services/value-transformer/types.js';
+/**
+ * Result of metadata resolution
+ */
+export interface MetadataResolutionResult {
+    /** Map of attribute slug → metadata for transformer */
+    metadataMap: Map<string, AttributeMetadata>;
+    /** Array of attribute slugs (lowercase) for field mapper */
+    availableAttributes: string[];
+    /** Whether result came from cache (true) or fresh fetch (false) */
+    fromCache: boolean;
+}
+/**
+ * MetadataResolver - Single source of truth for metadata fetching
+ */
+export declare class MetadataResolver {
+    /**
+     * Fetch metadata for a resource type with caching
+     *
+     * This is the single entry point for metadata fetching across
+     * UniversalUpdateService, UniversalCreateService, and value-transformer.
+     *
+     * @param resourceType - The resource type to fetch metadata for
+     * @param recordData - Optional record data containing object slug
+     * @returns Metadata map and available attributes for field mapping
+     */
+    static fetchMetadata(resourceType: UniversalResourceType, recordData?: Record<string, unknown>): Promise<MetadataResolutionResult>;
+    /**
+     * Fetch fresh metadata from Attio API
+     */
+    private static fetchFreshMetadata;
+    /**
+     * Extract object slug from resource type and record data
+     */
+    static extractObjectSlug(resourceType: UniversalResourceType, recordData?: Record<string, unknown>): string | undefined;
+    /**
+     * Extract attribute slugs for field mapper (lowercase)
+     */
+    private static extractAttributeSlugs;
+}
+//# sourceMappingURL=MetadataResolver.d.ts.map

package/dist/services/update/MetadataResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MetadataResolver.d.ts","sourceRoot":"","sources":["../../../src/services/update/MetadataResolver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AAGnF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAI/E;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,uDAAuD;IACvD,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC5C,4DAA4D;IAC5D,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,mEAAmE;IACnE,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAC3B;;;;;;;;;OASG;WACU,aAAa,CACxB,YAAY,EAAE,qBAAqB,EACnC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,OAAO,CAAC,wBAAwB,CAAC;IAkFpC;;OAEG;mBACkB,kBAAkB;IAevC;;OAEG;WACW,iBAAiB,CAC7B,YAAY,EAAE,qBAAqB,EACnC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,MAAM,GAAG,SAAS;IAcrB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,qBAAqB;CAarC"}

package/dist/services/update/MetadataResolver.js

@@ -0,0 +1,110 @@
+/**
+ * MetadataResolver - Centralized metadata fetching with caching
+ *
+ * Consolidates duplicate metadata fetching from UniversalUpdateService
+ * and value-transformer into a single, cacheable operation.
+ *
+ * @see Issue #984 - Consolidate metadata fetching to reduce API calls by 40-60%
+ */
+import { UniversalResourceType } from '../../handlers/tool-configs/universal/types.js';
+import { CachingService } from '../../services/CachingService.js';
+import { DEFAULT_ATTRIBUTES_CACHE_TTL } from '../../constants/universal.constants.js';
+import { debug, error as logError } from '../../utils/logger.js';
+import { convertToMetadataMap } from '../../utils/metadata-utils.js';
+/**
+ * MetadataResolver - Single source of truth for metadata fetching
+ */
+export class MetadataResolver {
+    /**
+     * Fetch metadata for a resource type with caching
+     *
+     * This is the single entry point for metadata fetching across
+     * UniversalUpdateService, UniversalCreateService, and value-transformer.
+     *
+     * @param resourceType - The resource type to fetch metadata for
+     * @param recordData - Optional record data containing object slug
+     * @returns Metadata map and available attributes for field mapping
+     */
+    static async fetchMetadata(resourceType, recordData) {
+        const objectSlug = this.extractObjectSlug(resourceType, recordData);
+        try {
+            // Try cache first, then load fresh data
+            const result = await CachingService.getOrLoadAttributes(() => this.fetchFreshMetadata(resourceType, objectSlug), resourceType, objectSlug, DEFAULT_ATTRIBUTES_CACHE_TTL);
+            // Use shared utility from metadata-utils (PR #1006 Phase 2.1)
+            const metadataMap = convertToMetadataMap(result.data);
+            const availableAttributes = this.extractAttributeSlugs(metadataMap);
+            debug('MetadataResolver', 'Metadata fetched', {
+                resourceType,
+                objectSlug,
+                fromCache: result.fromCache,
+                attributeCount: metadataMap.size,
+            });
+            return {
+                metadataMap,
+                availableAttributes,
+                fromCache: result.fromCache,
+            };
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            // Re-throw critical authentication errors (Issue #984 extension - PR review feedback)
+            if (error.message.includes('401') ||
+                error.message.includes('403') ||
+                error.message.includes('Unauthorized') ||
+                error.message.includes('Forbidden')) {
+                logError('MetadataResolver', 'Authentication error fetching metadata', error, { resourceType, objectSlug });
+                throw error;
+            }
+            // Re-throw schema validation errors
+            if (error.message.includes('validation') ||
+                error.message.includes('schema')) {
+                logError('MetadataResolver', 'Schema validation error fetching metadata', error, { resourceType, objectSlug });
+                throw error;
+            }
+            // Log and return empty for non-critical errors (transient failures, network issues)
+            logError('MetadataResolver', 'Non-critical metadata fetch error, using empty metadata', error, { resourceType, objectSlug });
+            debug('MetadataResolver', 'Graceful degradation with empty metadata', {
+                resourceType,
+                objectSlug,
+            });
+            return {
+                metadataMap: new Map(),
+                availableAttributes: [],
+                fromCache: false,
+            };
+        }
+    }
+    /**
+     * Fetch fresh metadata from Attio API
+     */
+    static async fetchFreshMetadata(resourceType, objectSlug) {
+        const { UniversalMetadataService } = await import('../../services/UniversalMetadataService.js');
+        const options = objectSlug ? { objectSlug } : undefined;
+        return UniversalMetadataService.discoverAttributesForResourceType(resourceType, options);
+    }
+    /**
+     * Extract object slug from resource type and record data
+     */
+    static extractObjectSlug(resourceType, recordData) {
+        if (resourceType === UniversalResourceType.RECORDS) {
+            return (recordData?.object ||
+                recordData?.object_api_slug ||
+                'records');
+        }
+        if (resourceType === UniversalResourceType.DEALS) {
+            return 'deals';
+        }
+        return undefined;
+    }
+    /**
+     * Extract attribute slugs for field mapper (lowercase)
+     */
+    static extractAttributeSlugs(metadataMap) {
+        return Array.from(new Set(Array.from(metadataMap.values()).flatMap((attr) => {
+            return [attr.api_slug, attr.title, attr.slug]
+                .filter((s) => typeof s === 'string')
+                .map((s) => s.toLowerCase());
+        })));
+    }
+}
+//# sourceMappingURL=MetadataResolver.js.map

package/dist/services/update/MetadataResolver.js.map

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

package/dist/services/update/ResponseNormalizer.d.ts

@@ -0,0 +1,12 @@
+import type { AttioRecord } from '../../types/attio.js';
+import type { UniversalResourceType } from '../../handlers/tool-configs/universal/types.js';
+export declare const ResponseNormalizer: {
+    normalizeResponseFormat(resourceType: UniversalResourceType, record: AttioRecord): AttioRecord;
+    normalizeCompanyRecord(record: AttioRecord): AttioRecord;
+    normalizePersonRecord(record: AttioRecord): AttioRecord;
+    normalizeListRecord(record: AttioRecord): AttioRecord;
+    normalizeTaskRecord(record: AttioRecord): AttioRecord;
+    normalizeDealRecord(record: AttioRecord): AttioRecord;
+    normalizeGenericRecord(record: AttioRecord): AttioRecord;
+};
+//# sourceMappingURL=ResponseNormalizer.d.ts.map

package/dist/services/update/ResponseNormalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResponseNormalizer.d.ts","sourceRoot":"","sources":["../../../src/services/update/ResponseNormalizer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AAE5F,eAAO,MAAM,kBAAkB;0CAEb,qBAAqB,UAC3B,WAAW,GAClB,WAAW;mCA+BiB,WAAW,GAAG,WAAW;kCAmB1B,WAAW,GAAG,WAAW;gCAsB3B,WAAW,GAAG,WAAW;gCAYzB,WAAW,GAAG,WAAW;gCAkBzB,WAAW,GAAG,WAAW;mCAgBtB,WAAW,GAAG,WAAW;CAOzD,CAAC"}

package/dist/services/update/ResponseNormalizer.js

@@ -0,0 +1,118 @@
+export const ResponseNormalizer = {
+    normalizeResponseFormat(resourceType, record) {
+        if (!record || typeof record !== 'object') {
+            throw new Error(`Invalid record format received for ${resourceType}: ${typeof record}`);
+        }
+        const normalized = {
+            id: record.id || { record_id: 'unknown' },
+            values: record.values || {},
+            created_at: record.created_at,
+            updated_at: record.updated_at || new Date().toISOString(),
+        };
+        switch (resourceType) {
+            case 'companies':
+                return this.normalizeCompanyRecord(normalized);
+            case 'people':
+                return this.normalizePersonRecord(normalized);
+            case 'lists':
+                return this.normalizeListRecord(normalized);
+            case 'tasks':
+                return this.normalizeTaskRecord(normalized);
+            case 'deals':
+                return this.normalizeDealRecord(normalized);
+            case 'records':
+                return this.normalizeGenericRecord(normalized);
+            default:
+                return normalized;
+        }
+    },
+    normalizeCompanyRecord(record) {
+        const idObj = record.id || {};
+        return {
+            ...record,
+            id: {
+                ...record.id,
+                object_id: idObj.object_id || 'companies',
+            },
+            values: {
+                ...record.values,
+                domains: Array.isArray(record.values.domains)
+                    ? record.values.domains
+                    : record.values.domains
+                        ? [record.values.domains]
+                        : record.values.domains,
+            },
+        };
+    },
+    normalizePersonRecord(record) {
+        const idObj = record.id || {};
+        const vals = record.values;
+        return {
+            ...record,
+            id: { ...record.id, object_id: idObj.object_id || 'people' },
+            values: {
+                ...record.values,
+                email_addresses: Array.isArray(vals.email_addresses)
+                    ? vals.email_addresses
+                    : vals.email_addresses
+                        ? [vals.email_addresses]
+                        : vals.email_addresses,
+                phone_numbers: Array.isArray(vals.phone_numbers)
+                    ? vals.phone_numbers
+                    : vals.phone_numbers
+                        ? [vals.phone_numbers]
+                        : vals.phone_numbers,
+            },
+        };
+    },
+    normalizeListRecord(record) {
+        const idObj = record.id || {};
+        return {
+            ...record,
+            id: {
+                ...record.id,
+                object_id: idObj.object_id || 'lists',
+                list_id: idObj.list_id || idObj.record_id,
+            },
+        };
+    },
+    normalizeTaskRecord(record) {
+        const idObj = record.id || {};
+        const vals = record.values;
+        return {
+            ...record,
+            id: {
+                ...record.id,
+                object_id: idObj.object_id || 'tasks',
+                task_id: idObj.task_id || idObj.record_id,
+            },
+            values: {
+                ...record.values,
+                content: vals.content || vals.title,
+                title: vals.title || vals.content,
+            },
+        };
+    },
+    normalizeDealRecord(record) {
+        const idObj = record.id || {};
+        const vals = record.values;
+        return {
+            ...record,
+            id: { ...record.id, object_id: idObj.object_id || 'deals' },
+            values: {
+                ...record.values,
+                value: vals.value && typeof vals.value === 'string'
+                    ? parseFloat(vals.value) || vals.value
+                    : vals.value,
+            },
+        };
+    },
+    normalizeGenericRecord(record) {
+        const idObj = record.id || {};
+        return {
+            ...record,
+            id: { ...record.id, object_id: idObj.object_id || 'records' },
+        };
+    },
+};
+//# sourceMappingURL=ResponseNormalizer.js.map

package/dist/services/update/ResponseNormalizer.js.map

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

package/dist/services/update/UpdateOrchestrator.d.ts

@@ -0,0 +1,37 @@
+/**
+ * UpdateOrchestrator - Strategy pattern orchestration for updates
+ *
+ * Extracted from UniversalUpdateService to separate concerns.
+ * Delegates to resource-specific update strategies.
+ *
+ * @see Issue #984 - Modularize UniversalUpdateService (831→220 lines)
+ */
+import { UniversalResourceType } from '../../handlers/tool-configs/universal/types.js';
+import type { AttioRecord } from '../../types/attio.js';
+/**
+ * Context for update orchestration
+ */
+export interface UpdateContext {
+    /** Resource type being updated */
+    resourceType: UniversalResourceType;
+    /** ID of the record to update */
+    recordId: string;
+    /** Sanitized values to update */
+    sanitizedValues: Record<string, unknown>;
+    /** Optional object slug for records/deals */
+    objectSlug?: string;
+}
+/**
+ * UpdateOrchestrator - Delegates updates to resource-specific strategies
+ */
+export declare class UpdateOrchestrator {
+    /**
+     * Dispatch update to appropriate strategy based on resource type
+     *
+     * @param context - Update context with resource type, record ID, values, and options
+     * @returns Updated record from Attio API
+     * @throws Error if resource type is unsupported
+     */
+    static executeUpdate(context: UpdateContext): Promise<AttioRecord>;
+}
+//# sourceMappingURL=UpdateOrchestrator.d.ts.map

package/dist/services/update/UpdateOrchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UpdateOrchestrator.d.ts","sourceRoot":"","sources":["../../../src/services/update/UpdateOrchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AACnF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGpD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,kCAAkC;IAClC,YAAY,EAAE,qBAAqB,CAAC;IACpC,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,kBAAkB;IAC7B;;;;;;OAMG;WACU,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC;CA2EzE"}

package/dist/services/update/UpdateOrchestrator.js

@@ -0,0 +1,58 @@
+/**
+ * UpdateOrchestrator - Strategy pattern orchestration for updates
+ *
+ * Extracted from UniversalUpdateService to separate concerns.
+ * Delegates to resource-specific update strategies.
+ *
+ * @see Issue #984 - Modularize UniversalUpdateService (831→220 lines)
+ */
+import { UniversalResourceType } from '../../handlers/tool-configs/universal/types.js';
+import { debug } from '../../utils/logger.js';
+/**
+ * UpdateOrchestrator - Delegates updates to resource-specific strategies
+ */
+export class UpdateOrchestrator {
+    /**
+     * Dispatch update to appropriate strategy based on resource type
+     *
+     * @param context - Update context with resource type, record ID, values, and options
+     * @returns Updated record from Attio API
+     * @throws Error if resource type is unsupported
+     */
+    static async executeUpdate(context) {
+        const { resourceType, recordId, sanitizedValues, objectSlug } = context;
+        debug('UpdateOrchestrator', 'Dispatching update', {
+            resourceType,
+            recordId,
+            objectSlug,
+            fieldCount: Object.keys(sanitizedValues).length,
+        });
+        switch (resourceType) {
+            case UniversalResourceType.COMPANIES: {
+                const { CompanyUpdateStrategy } = await import('./strategies/CompanyUpdateStrategy.js');
+                return new CompanyUpdateStrategy().update(recordId, sanitizedValues, resourceType);
+            }
+            case UniversalResourceType.LISTS: {
+                const { ListUpdateStrategy } = await import('./strategies/ListUpdateStrategy.js');
+                return new ListUpdateStrategy().update(recordId, sanitizedValues, resourceType);
+            }
+            case UniversalResourceType.PEOPLE: {
+                const { PersonUpdateStrategy } = await import('./strategies/PersonUpdateStrategy.js');
+                return new PersonUpdateStrategy().update(recordId, sanitizedValues, resourceType);
+            }
+            case UniversalResourceType.RECORDS:
+            case UniversalResourceType.DEALS: {
+                const { RecordUpdateStrategy } = await import('./strategies/RecordUpdateStrategy.js');
+                return new RecordUpdateStrategy().update(recordId, sanitizedValues, resourceType, { objectSlug: objectSlug || 'records' });
+            }
+            case UniversalResourceType.TASKS: {
+                const { TaskUpdateStrategy } = await import('./strategies/TaskUpdateStrategy.js');
+                return new TaskUpdateStrategy().update(recordId, sanitizedValues, resourceType);
+            }
+            default: {
+                throw new Error(`Unsupported resource type for update: ${resourceType}`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=UpdateOrchestrator.js.map

package/dist/services/update/UpdateOrchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UpdateOrchestrator.js","sourceRoot":"","sources":["../../../src/services/update/UpdateOrchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AAEnF,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAgB1C;;GAEG;AACH,MAAM,OAAO,kBAAkB;IAC7B;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,OAAsB;QAC/C,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;QAExE,KAAK,CAAC,oBAAoB,EAAE,oBAAoB,EAAE;YAChD,YAAY;YACZ,QAAQ;YACR,UAAU;YACV,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,MAAM;SAChD,CAAC,CAAC;QAEH,QAAQ,YAAY,EAAE,CAAC;YACrB,KAAK,qBAAqB,CAAC,SAAS,CAAC,CAAC,CAAC;gBACrC,MAAM,EAAE,qBAAqB,EAAE,GAAG,MAAM,MAAM,CAC5C,uCAAuC,CACxC,CAAC;gBACF,OAAO,IAAI,qBAAqB,EAAE,CAAC,MAAM,CACvC,QAAQ,EACR,eAAe,EACf,YAAY,CACb,CAAC;YACJ,CAAC;YAED,KAAK,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAAC;gBACjC,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CACzC,oCAAoC,CACrC,CAAC;gBACF,OAAO,IAAI,kBAAkB,EAAE,CAAC,MAAM,CACpC,QAAQ,EACR,eAAe,EACf,YAAY,CACb,CAAC;YACJ,CAAC;YAED,KAAK,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC;gBAClC,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAC3C,sCAAsC,CACvC,CAAC;gBACF,OAAO,IAAI,oBAAoB,EAAE,CAAC,MAAM,CACtC,QAAQ,EACR,eAAe,EACf,YAAY,CACb,CAAC;YACJ,CAAC;YAED,KAAK,qBAAqB,CAAC,OAAO,CAAC;YACnC,KAAK,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAAC;gBACjC,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAC3C,sCAAsC,CACvC,CAAC;gBACF,OAAO,IAAI,oBAAoB,EAAE,CAAC,MAAM,CACtC,QAAQ,EACR,eAAe,EACf,YAAY,EACZ,EAAE,UAAU,EAAE,UAAU,IAAI,SAAS,EAAE,CACxC,CAAC;YACJ,CAAC;YAED,KAAK,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAAC;gBACjC,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CACzC,oCAAoC,CACrC,CAAC;gBACF,OAAO,IAAI,kBAAkB,EAAE,CAAC,MAAM,CACpC,QAAQ,EACR,eAAe,EACf,YAAY,CACb,CAAC;YACJ,CAAC;YAED,OAAO,CAAC,CAAC,CAAC;gBACR,MAAM,IAAI,KAAK,CACb,yCAAyC,YAAY,EAAE,CACxD,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/services/update/UpdateValidation.d.ts

@@ -0,0 +1,62 @@
+import type { AttioRecord } from '../../types/attio.js';
+import type { UniversalResourceType } from '../../handlers/tool-configs/universal/types.js';
+export declare const UpdateValidation: {
+    hasForbiddenContent(values: Record<string, unknown>): boolean;
+    assertNoTaskContentUpdate(recordData: Record<string, unknown>): void;
+    sanitizeSpecialCharacters(data: Record<string, unknown>): Record<string, unknown>;
+    verifyFieldPersistence(resourceType: UniversalResourceType, recordId: string, expectedUpdates: Record<string, unknown>): Promise<{
+        verified: boolean;
+        discrepancies: string[];
+        warnings: string[];
+    }>;
+    fetchRecordForVerification(resourceType: UniversalResourceType, recordId: string): Promise<AttioRecord | null>;
+    /**
+     * Check if a field is a status-type field (stage, status, etc.)
+     * Enhanced to recognize more status field variations (Issue #995)
+     *
+     * Uses exact matching and suffix patterns to avoid false positives
+     * from unrelated fields like "status_code" or "status_updated_at"
+     */
+    isStatusField(fieldName: string): boolean;
+    /**
+     * Handle null or undefined values
+     */
+    handleNullValues(expectedValue: unknown, actualValue: unknown): {
+        matches: boolean;
+    } | null;
+    /**
+     * Unwrap array responses from Attio API
+     * Handles both status fields and regular value fields
+     */
+    unwrapArrayValue(fieldName: string, actualValue: unknown): unknown;
+    /**
+     * Compare array values using set comparison
+     */
+    compareArrayValues(expectedValue: unknown[], actualValue: unknown): {
+        matches: boolean;
+    };
+    /**
+     * Compare string values with case-insensitive fallback
+     */
+    compareStringValues(fieldName: string, expectedValue: string, actualValue: unknown): {
+        matches: boolean;
+        warning?: string;
+    };
+    /**
+     * Compare status objects (like deal stages)
+     */
+    compareStatusObjects(fieldName: string, expectedValue: Record<string, unknown>, actualValue: unknown): {
+        matches: boolean;
+    } | null;
+    /**
+     * Compare primitive values (number, boolean, string)
+     */
+    comparePrimitiveValues(expectedValue: unknown, actualValue: unknown): {
+        matches: boolean;
+    };
+    compareFieldValues(fieldName: string, expectedValue: unknown, actualValue: unknown): {
+        matches: boolean;
+        warning?: string;
+    };
+};
+//# sourceMappingURL=UpdateValidation.d.ts.map