attio-mcp 0.1.2 → 1.0.0

package/dist/services/search-utilities/SearchUtilities.js

@@ -0,0 +1,235 @@
+/**
+ * Search utilities extracted from UniversalSearchService
+ * Issue #574: Extract shared utilities for reuse
+ */
+/**
+ * Utility functions for search operations
+ */
+export class SearchUtilities {
+    /**
+     * Rank search results by relevance based on query match frequency
+     * This provides client-side relevance scoring since Attio API doesn't have native relevance ranking
+     */
+    static rankByRelevance(results, query, searchFields) {
+        // Calculate relevance score for each result
+        const scoredResults = results.map((record) => {
+            let score = 0;
+            const queryLower = query.toLowerCase();
+            // Check each search field for matches
+            searchFields.forEach((field) => {
+                const fieldValue = this.getFieldValue(record, field);
+                if (fieldValue) {
+                    const valueLower = fieldValue.toLowerCase();
+                    // Exact match gets highest score
+                    if (valueLower === queryLower) {
+                        score += 100;
+                    }
+                    // Starts with query gets high score
+                    else if (valueLower.startsWith(queryLower)) {
+                        score += 50;
+                    }
+                    // Contains query gets moderate score
+                    else if (valueLower.includes(queryLower)) {
+                        score += 25;
+                        // Additional score for more occurrences
+                        const matches = valueLower.split(queryLower).length - 1;
+                        score += matches * 10;
+                    }
+                    // Partial word match gets lower score
+                    else {
+                        const queryWords = queryLower.split(/\s+/);
+                        queryWords.forEach((word) => {
+                            if (valueLower.includes(word)) {
+                                score += 5;
+                            }
+                        });
+                    }
+                }
+            });
+            return { record, score };
+        });
+        // Sort by score (descending) then by name
+        scoredResults.sort((a, b) => {
+            if (b.score !== a.score) {
+                return b.score - a.score;
+            }
+            // Secondary sort by name if scores are equal
+            const nameA = this.getFieldValue(a.record, 'name') || '';
+            const nameB = this.getFieldValue(b.record, 'name') || '';
+            return nameA.localeCompare(nameB);
+        });
+        return scoredResults.map((item) => item.record);
+    }
+    /**
+     * Helper method to extract field value from a record
+     * Issue #598: Simplified with better type safety and helper methods
+     */
+    static getFieldValue(record, field) {
+        const values = record.values;
+        if (!values)
+            return '';
+        const fieldValue = values[field];
+        return this.extractStringFromFieldValue(fieldValue);
+    }
+    /**
+     * Extract string value from various Attio field value structures
+     */
+    static extractStringFromFieldValue(fieldValue) {
+        if (typeof fieldValue === 'string') {
+            return fieldValue;
+        }
+        if (Array.isArray(fieldValue)) {
+            return this.extractStringFromArray(fieldValue);
+        }
+        if (this.isFieldValueObject(fieldValue)) {
+            return String(fieldValue.value || '');
+        }
+        return '';
+    }
+    /**
+     * Extract string from array field values (e.g., email_addresses)
+     */
+    static extractStringFromArray(fieldArray) {
+        if (fieldArray.length === 0)
+            return '';
+        const firstItem = fieldArray[0];
+        if (typeof firstItem === 'string') {
+            return firstItem;
+        }
+        if (this.isFieldValueObject(firstItem)) {
+            return String(firstItem.value || '');
+        }
+        return '';
+    }
+    /**
+     * Type guard for field value objects
+     */
+    static isFieldValueObject(value) {
+        return (value !== null &&
+            value !== undefined &&
+            typeof value === 'object' &&
+            'value' in value);
+    }
+    /**
+     * Helper method to extract field value from a list record for content search
+     */
+    static getListFieldValue(list, field) {
+        const values = list.values;
+        if (!values)
+            return '';
+        const fieldValue = values[field];
+        // Handle different field value structures for lists
+        if (typeof fieldValue === 'string') {
+            return fieldValue;
+        }
+        else if (fieldValue &&
+            typeof fieldValue === 'object' &&
+            'value' in fieldValue) {
+            return String(fieldValue.value || '');
+        }
+        return '';
+    }
+    /**
+     * Helper method to extract field value from a task record for content search
+     */
+    static getTaskFieldValue(task, field) {
+        const values = task.values;
+        if (!values)
+            return '';
+        const fieldValue = values[field];
+        // Handle different field value structures for tasks
+        if (typeof fieldValue === 'string') {
+            return fieldValue;
+        }
+        else if (fieldValue &&
+            typeof fieldValue === 'object' &&
+            'value' in fieldValue) {
+            return String(fieldValue.value || '');
+        }
+        return '';
+    }
+    /**
+     * Create date filter from timeframe parameters
+     */
+    static createDateFilter(timeframeParams) {
+        const { timeframe_attribute, start_date, end_date, date_operator } = timeframeParams;
+        if (!timeframe_attribute) {
+            return null;
+        }
+        const filters = [];
+        if (date_operator === 'between' && start_date && end_date) {
+            // Between date range - use valid API conditions
+            filters.push({
+                attribute: { slug: timeframe_attribute },
+                condition: 'greater_than',
+                value: start_date,
+            });
+            filters.push({
+                attribute: { slug: timeframe_attribute },
+                condition: 'less_than',
+                value: end_date,
+            });
+        }
+        else if (date_operator === 'greater_than' && start_date) {
+            // After start date - use valid API condition
+            filters.push({
+                attribute: { slug: timeframe_attribute },
+                condition: 'greater_than',
+                value: start_date,
+            });
+        }
+        else if (date_operator === 'less_than' && end_date) {
+            // Before end date - use valid API condition
+            filters.push({
+                attribute: { slug: timeframe_attribute },
+                condition: 'less_than',
+                value: end_date,
+            });
+        }
+        else if (date_operator === 'equals' && start_date) {
+            // Exact date match
+            filters.push({
+                attribute: { slug: timeframe_attribute },
+                condition: 'equals',
+                value: start_date,
+            });
+        }
+        if (filters.length === 0) {
+            return null;
+        }
+        return {
+            filters,
+            matchAny: false, // Use AND logic for date ranges
+        };
+    }
+    /**
+     * Merge timeframe filters with existing filters
+     */
+    static mergeFilters(existingFilters, dateFilter) {
+        if (!existingFilters) {
+            return dateFilter;
+        }
+        // If existing filters already has a filters array, merge them
+        if (Array.isArray(existingFilters.filters) &&
+            Array.isArray(dateFilter.filters)) {
+            return {
+                ...existingFilters,
+                filters: [...existingFilters.filters, ...dateFilter.filters],
+            };
+        }
+        // Otherwise, create a new structure with both sets of filters
+        const existingFilterArray = Array.isArray(existingFilters.filters)
+            ? existingFilters.filters
+            : [];
+        const dateFilterArray = Array.isArray(dateFilter.filters)
+            ? dateFilter.filters
+            : [];
+        return {
+            ...existingFilters,
+            filters: [...existingFilterArray, ...dateFilterArray],
+            // Preserve existing matchAny logic if it exists
+            matchAny: existingFilters.matchAny || false,
+        };
+    }
+}
+//# sourceMappingURL=SearchUtilities.js.map

package/dist/services/search-utilities/SearchUtilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchUtilities.js","sourceRoot":"","sources":["../../../src/services/search-utilities/SearchUtilities.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/UpdateValidation.d.ts

@@ -0,0 +1,58 @@
+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 name represents a status field (like deal stages)
+     */
+    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

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

@@ -0,0 +1 @@
+{"version":3,"file":"UpdateValidation.d.ts","sourceRoot":"","sources":["../../../src/services/update/UpdateValidation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AASxD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AAG5F,eAAO,MAAM,gBAAgB;gCACC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;0CAMvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;oCAU5D,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;yCAqBV,qBAAqB,YACzB,MAAM,mBACC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvC,OAAO,CAAC;QACT,QAAQ,EAAE,OAAO,CAAC;QAClB,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;6CA+Dc,qBAAqB,YACzB,MAAM,GACf,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAwD9B;;OAEG;6BACsB,MAAM,GAAG,OAAO;IAIzC;;OAEG;oCAEc,OAAO,eACT,OAAO,GACnB;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IAU9B;;;OAGG;gCACyB,MAAM,eAAe,OAAO,GAAG,OAAO;IA4BlE;;OAEG;sCAEc,OAAO,EAAE,eACX,OAAO,GACnB;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE;IAevB;;OAEG;mCAEU,MAAM,iBACF,MAAM,eACR,OAAO,GACnB;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;IAczC;;OAEG;oCAEU,MAAM,iBACF,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,eACzB,OAAO,GACnB;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IAU9B;;OAEG;0CAEc,OAAO,eACT,OAAO,GACnB;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE;kCAgBV,MAAM,iBACF,OAAO,eACT,OAAO,GACnB;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;CAuC1C,CAAC"}