attio-mcp 0.1.2 → 1.1.0

package/dist/services/search-strategies/interfaces.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Search strategy interfaces for UniversalSearchService refactoring
+ * Issue #574: Extract resource-specific search strategies
+ */
+import { AttioRecord, AttioList, AttioTask } from '../../types/attio.js';
+import { SearchType, MatchType, SortType } from '../../handlers/tool-configs/universal/types.js';
+/**
+ * Timeframe parameters for date-based filtering
+ */
+export interface TimeframeParams {
+    timeframe_attribute?: string;
+    start_date?: string;
+    end_date?: string;
+    date_operator?: 'greater_than' | 'less_than' | 'between' | 'equals';
+}
+/**
+ * Common search parameters for all strategies
+ */
+export interface SearchStrategyParams {
+    query?: string;
+    filters?: Record<string, unknown>;
+    limit?: number;
+    offset?: number;
+    search_type?: SearchType;
+    fields?: string[];
+    match_type?: MatchType;
+    sort?: SortType;
+    timeframeParams?: TimeframeParams;
+}
+/**
+ * Interface for search strategy implementations
+ */
+export interface ISearchStrategy {
+    /**
+     * Execute the search for this resource type
+     */
+    search(params: SearchStrategyParams): Promise<AttioRecord[]>;
+    /**
+     * Get the resource type this strategy handles
+     */
+    getResourceType(): string;
+    /**
+     * Check if advanced filtering is supported
+     */
+    supportsAdvancedFiltering(): boolean;
+    /**
+     * Check if query-based search is supported
+     */
+    supportsQuerySearch(): boolean;
+}
+/**
+ * Dependencies that strategies may need
+ */
+export interface StrategyDependencies {
+    advancedSearchFunction?: ((filters: Record<string, unknown>, limit?: number, offset?: number) => Promise<AttioRecord[]>) | null;
+    paginatedSearchFunction?: ((filters: Record<string, unknown>, pagination: {
+        limit?: number;
+        offset?: number;
+    }) => Promise<{
+        results: AttioRecord[];
+    }>) | null;
+    listFunction?: (query?: string, limit?: number, offset?: number) => Promise<AttioList[]>;
+    taskFunction?: (status?: string, assigneeId?: string, page?: number, pageSize?: number) => Promise<AttioTask[]>;
+    createDateFilter?: (params: TimeframeParams) => Record<string, unknown> | null;
+    mergeFilters?: (existing: Record<string, unknown> | undefined, dateFilter: Record<string, unknown>) => Record<string, unknown>;
+    rankByRelevance?: (results: AttioRecord[], query: string, searchFields: string[]) => AttioRecord[];
+    getFieldValue?: (record: AttioRecord, field: string) => string;
+}
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/services/search-strategies/interfaces.d.ts.map

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

package/dist/services/search-strategies/interfaces.js

@@ -0,0 +1,6 @@
+/**
+ * Search strategy interfaces for UniversalSearchService refactoring
+ * Issue #574: Extract resource-specific search strategies
+ */
+export {};
+//# sourceMappingURL=interfaces.js.map

package/dist/services/search-strategies/interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../../src/services/search-strategies/interfaces.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/services/search-strategies/query-filter-builder.d.ts

@@ -0,0 +1,5 @@
+import { ListEntryFilters } from '../../api/operations/types.js';
+import { MatchType } from '../../handlers/tool-configs/universal/types.js';
+export declare function buildPeopleQueryFilters(query: string, matchType?: MatchType): ListEntryFilters | null;
+export declare function buildCompanyQueryFilters(query: string, matchType?: MatchType): ListEntryFilters | null;
+//# sourceMappingURL=query-filter-builder.d.ts.map

package/dist/services/search-strategies/query-filter-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-filter-builder.d.ts","sourceRoot":"","sources":["../../../src/services/search-strategies/query-filter-builder.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAE,MAAM,gDAAgD,CAAC;AAkE3E,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,SAAS,GACpB,gBAAgB,GAAG,IAAI,CAmDzB;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,SAAS,GACpB,gBAAgB,GAAG,IAAI,CAuCzB"}

package/dist/services/search-strategies/query-filter-builder.js

@@ -0,0 +1,129 @@
+import { parseQuery } from '../../api/operations/query-parser.js';
+import { MatchType } from '../../handlers/tool-configs/universal/types.js';
+/**
+ * Maps attribute slugs to their filterable property names for explicit operator filtering.
+ * Multivalue attributes require filtering by their property names, not the attribute slug.
+ *
+ * Examples:
+ * - email_addresses attribute → filter by "email_address" property
+ * - phone_numbers attribute → filter by "number" property
+ * - name attribute → filter by "full_name", "first_name", or "last_name" properties
+ */
+const ATTRIBUTE_TO_PROPERTY_MAP = {
+    email_addresses: 'email_address',
+    phone_numbers: 'number', // or 'normalized' for normalized phone format
+    name: 'full_name',
+    domains: 'domain',
+};
+const TOKEN_STOPWORDS = new Set([
+    'and',
+    'the',
+    'with',
+    'for',
+    'from',
+    'company',
+    'inc',
+    'llc',
+    'co',
+]);
+const MAX_TOKENS = 25;
+function getCondition(matchType, fallback = 'contains') {
+    if (matchType === MatchType.EXACT) {
+        return 'equals';
+    }
+    return fallback;
+}
+function addFilter(filters, seen, slug, value, condition) {
+    if (!value) {
+        return;
+    }
+    const key = `${slug}:${condition}:${value.toLowerCase()}`;
+    if (seen.has(key)) {
+        return;
+    }
+    seen.add(key);
+    filters.push({
+        attribute: { slug },
+        condition,
+        value,
+    });
+}
+export function buildPeopleQueryFilters(query, matchType) {
+    const trimmed = query.trim();
+    if (!trimmed) {
+        return null;
+    }
+    const parsed = parseQuery(trimmed);
+    const filters = [];
+    const seen = new Set();
+    const condition = getCondition(matchType);
+    // Prioritize direct email and phone matches - these are most specific
+    parsed.emails.forEach((email) => {
+        addFilter(filters, seen, 'email_addresses', email, condition);
+    });
+    parsed.phones.forEach((phone) => {
+        addFilter(filters, seen, 'phone_numbers', phone, condition);
+    });
+    // Token-based name matching for multi-field queries
+    // For people searches, also add tokens to email filter since they might be
+    // partial email addresses (e.g., "examplename" in "examplename@example.com")
+    const hasStructuredEmail = parsed.emails.length > 0;
+    parsed.tokens.slice(0, MAX_TOKENS).forEach((token) => {
+        if (TOKEN_STOPWORDS.has(token.toLowerCase())) {
+            return;
+        }
+        addFilter(filters, seen, 'name', token, condition);
+        // If token is long enough, and we didn't extract explicit emails,
+        // also search email addresses (likely email local part)
+        if (!hasStructuredEmail && token.length >= 5) {
+            addFilter(filters, seen, 'email_addresses', token, condition);
+        }
+    });
+    // If no structured data was found, search the raw query
+    if (filters.length === 0) {
+        addFilter(filters, seen, 'name', trimmed, condition);
+    }
+    if (filters.length === 0) {
+        return null;
+    }
+    // Use OR logic to match any of the filters
+    return {
+        filters,
+        matchAny: true,
+    };
+}
+export function buildCompanyQueryFilters(query, matchType) {
+    const trimmed = query.trim();
+    if (!trimmed) {
+        return null;
+    }
+    const parsed = parseQuery(trimmed);
+    const filters = [];
+    const seen = new Set();
+    const condition = getCondition(matchType);
+    // Domains extracted from emails - most specific
+    parsed.domains.forEach((domain) => {
+        addFilter(filters, seen, 'domains', domain, condition);
+    });
+    // Token-based matching - add to both name and domains for broader search
+    parsed.tokens.slice(0, MAX_TOKENS).forEach((token) => {
+        if (TOKEN_STOPWORDS.has(token.toLowerCase())) {
+            return;
+        }
+        addFilter(filters, seen, 'name', token, condition);
+        addFilter(filters, seen, 'domains', token, condition);
+    });
+    // If no structured data found, search raw query
+    if (filters.length === 0) {
+        addFilter(filters, seen, 'name', trimmed, condition);
+    }
+    if (filters.length === 0) {
+        return null;
+    }
+    // Use OR logic to match any of the filters
+    return {
+        filters,
+        matchAny: true,
+    };
+}
+//# sourceMappingURL=query-filter-builder.js.map

package/dist/services/search-strategies/query-filter-builder.js.map

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

package/dist/services/search-utilities/FunctionValidator.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Utility for validating function availability with consistent error handling
+ * Issue #598: Extract common error handling pattern from UniversalSearchService
+ */
+/**
+ * Generic function validation utility that follows the ensure function availability pattern
+ *
+ * @param fn - The function to validate
+ * @param functionName - Name of the function for logging purposes
+ * @param serviceName - Name of the service for logging context
+ * @returns The validated function or null if invalid
+ */
+export declare const ensureFunctionAvailability: <T extends (...args: any[]) => unknown>(fn: T | null | undefined, functionName: string, serviceName?: string) => Promise<T | null>;
+//# sourceMappingURL=FunctionValidator.d.ts.map

package/dist/services/search-utilities/FunctionValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FunctionValidator.d.ts","sourceRoot":"","sources":["../../../src/services/search-utilities/FunctionValidator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,GAErC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,EAErC,IAAI,CAAC,GAAG,IAAI,GAAG,SAAS,EACxB,cAAc,MAAM,EACpB,cAAa,MAAiC,KAC7C,OAAO,CAAC,CAAC,GAAG,IAAI,CAkBlB,CAAC"}

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

@@ -0,0 +1,32 @@
+/**
+ * Utility for validating function availability with consistent error handling
+ * Issue #598: Extract common error handling pattern from UniversalSearchService
+ */
+import { debug, error } from '../../utils/logger.js';
+/**
+ * Generic function validation utility that follows the ensure function availability pattern
+ *
+ * @param fn - The function to validate
+ * @param functionName - Name of the function for logging purposes
+ * @param serviceName - Name of the service for logging context
+ * @returns The validated function or null if invalid
+ */
+export const ensureFunctionAvailability = async (fn, functionName, serviceName = 'UniversalSearchService') => {
+    try {
+        debug(serviceName, `Checking ${functionName} availability`, {
+            type: typeof fn,
+        });
+        if (typeof fn !== 'function') {
+            error(serviceName, `${functionName} is not a function`, {
+                [functionName]: fn,
+            });
+            return null;
+        }
+        return fn;
+    }
+    catch (err) {
+        error(serviceName, `Error accessing ${functionName}`, err);
+        return null;
+    }
+};
+//# sourceMappingURL=FunctionValidator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FunctionValidator.js","sourceRoot":"","sources":["../../../src/services/search-utilities/FunctionValidator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAErD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,KAAK,EAI7C,EAAwB,EACxB,YAAoB,EACpB,cAAsB,wBAAwB,EAC3B,EAAE;IACrB,IAAI,CAAC;QACH,KAAK,CAAC,WAAW,EAAE,YAAY,YAAY,eAAe,EAAE;YAC1D,IAAI,EAAE,OAAO,EAAE;SAChB,CAAC,CAAC;QAEH,IAAI,OAAO,EAAE,KAAK,UAAU,EAAE,CAAC;YAC7B,KAAK,CAAC,WAAW,EAAE,GAAG,YAAY,oBAAoB,EAAE;gBACtD,CAAC,YAAY,CAAC,EAAE,EAAE;aACnB,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,EAAO,CAAC;IACjB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,KAAK,CAAC,WAAW,EAAE,mBAAmB,YAAY,EAAE,EAAE,GAAG,CAAC,CAAC;QAC3D,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC,CAAC"}

package/dist/services/search-utilities/SearchUtilities.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Search utilities extracted from UniversalSearchService
+ * Issue #574: Extract shared utilities for reuse
+ */
+import { AttioRecord } from '../../types/attio.js';
+import { TimeframeParams } from '../search-strategies/interfaces.js';
+/**
+ * Utility functions for search operations
+ */
+export declare 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: AttioRecord[], query: string, searchFields: string[]): AttioRecord[];
+    /**
+     * Helper method to extract field value from a record
+     * Issue #598: Simplified with better type safety and helper methods
+     */
+    static getFieldValue(record: AttioRecord, field: string): string;
+    /**
+     * Extract string value from various Attio field value structures
+     */
+    private static extractStringFromFieldValue;
+    /**
+     * Extract string from array field values (e.g., email_addresses)
+     */
+    private static extractStringFromArray;
+    /**
+     * Type guard for field value objects
+     */
+    private static isFieldValueObject;
+    /**
+     * Helper method to extract field value from a list record for content search
+     */
+    static getListFieldValue(list: AttioRecord, field: string): string;
+    /**
+     * Helper method to extract field value from a task record for content search
+     */
+    static getTaskFieldValue(task: AttioRecord, field: string): string;
+    /**
+     * Create date filter from timeframe parameters
+     */
+    static createDateFilter(timeframeParams: TimeframeParams): Record<string, unknown> | null;
+    /**
+     * Merge timeframe filters with existing filters
+     */
+    static mergeFilters(existingFilters: Record<string, unknown> | undefined, dateFilter: Record<string, unknown>): Record<string, unknown>;
+}
+//# sourceMappingURL=SearchUtilities.d.ts.map

package/dist/services/search-utilities/SearchUtilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchUtilities.d.ts","sourceRoot":"","sources":["../../../src/services/search-utilities/SearchUtilities.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAkBrE;;GAEG;AACH,qBAAa,eAAe;IAC1B;;;OAGG;IACH,MAAM,CAAC,eAAe,CACpB,OAAO,EAAE,WAAW,EAAE,EACtB,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,MAAM,EAAE,GACrB,WAAW,EAAE;IAwDhB;;;OAGG;IACH,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAQhE;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,2BAA2B;IAkB1C;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAiBrC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAWjC;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAoBlE;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAoBlE;;OAEG;IACH,MAAM,CAAC,gBAAgB,CACrB,eAAe,EAAE,eAAe,GAC/B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAuDjC;;OAEG;IACH,MAAM,CAAC,YAAY,CACjB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EACpD,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CA+B3B"}

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":"AAAA;;;GAGG;AAqBH;;GAEG;AACH,MAAM,OAAO,eAAe;IAC1B;;;OAGG;IACH,MAAM,CAAC,eAAe,CACpB,OAAsB,EACtB,KAAa,EACb,YAAsB;QAEtB,4CAA4C;QAC5C,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;YAC3C,IAAI,KAAK,GAAG,CAAC,CAAC;YACd,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;YAEvC,sCAAsC;YACtC,YAAY,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;gBAC7B,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;gBACrD,IAAI,UAAU,EAAE,CAAC;oBACf,MAAM,UAAU,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;oBAE5C,iCAAiC;oBACjC,IAAI,UAAU,KAAK,UAAU,EAAE,CAAC;wBAC9B,KAAK,IAAI,GAAG,CAAC;oBACf,CAAC;oBACD,oCAAoC;yBAC/B,IAAI,UAAU,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;wBAC3C,KAAK,IAAI,EAAE,CAAC;oBACd,CAAC;oBACD,qCAAqC;yBAChC,IAAI,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;wBACzC,KAAK,IAAI,EAAE,CAAC;wBACZ,wCAAwC;wBACxC,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;wBACxD,KAAK,IAAI,OAAO,GAAG,EAAE,CAAC;oBACxB,CAAC;oBACD,sCAAsC;yBACjC,CAAC;wBACJ,MAAM,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;wBAC3C,UAAU,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;4BAC1B,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gCAC9B,KAAK,IAAI,CAAC,CAAC;4BACb,CAAC;wBACH,CAAC,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAC3B,CAAC,CAAC,CAAC;QAEH,0CAA0C;QAC1C,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YAC1B,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC;gBACxB,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;YAC3B,CAAC;YACD,6CAA6C;YAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;YACzD,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;YACzD,OAAO,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QAEH,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAClD,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,aAAa,CAAC,MAAmB,EAAE,KAAa;QACrD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAyC,CAAC;QAChE,IAAI,CAAC,MAAM;YAAE,OAAO,EAAE,CAAC;QAEvB,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC,2BAA2B,CAAC,UAAU,CAAC,CAAC;IACtD,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,2BAA2B,CACxC,UAA2B;QAE3B,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;YACnC,OAAO,UAAU,CAAC;QACpB,CAAC;QAED,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAC,sBAAsB,CAAC,UAAU,CAAC,CAAC;QACjD,CAAC;QAED,IAAI,IAAI,CAAC,kBAAkB,CAAC,UAAU,CAAC,EAAE,CAAC;YACxC,OAAO,MAAM,CAAC,UAAU,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QACxC,CAAC;QAED,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,sBAAsB,CACnC,UAAgC;QAEhC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAEvC,MAAM,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QAChC,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;YAClC,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,IAAI,IAAI,CAAC,kBAAkB,CAAC,SAAS,CAAC,EAAE,CAAC;YACvC,OAAO,MAAM,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QACvC,CAAC;QAED,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,kBAAkB,CAC/B,KAAc;QAEd,OAAO,CACL,KAAK,KAAK,IAAI;YACd,KAAK,KAAK,SAAS;YACnB,OAAO,KAAK,KAAK,QAAQ;YACzB,OAAO,IAAI,KAAK,CACjB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,IAAiB,EAAE,KAAa;QACvD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAiC,CAAC;QACtD,IAAI,CAAC,MAAM;YAAE,OAAO,EAAE,CAAC;QAEvB,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAEjC,oDAAoD;QACpD,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;YACnC,OAAO,UAAU,CAAC;QACpB,CAAC;aAAM,IACL,UAAU;YACV,OAAO,UAAU,KAAK,QAAQ;YAC9B,OAAO,IAAI,UAAU,EACrB,CAAC;YACD,OAAO,MAAM,CAAE,UAAiC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAChE,CAAC;QAED,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,IAAiB,EAAE,KAAa;QACvD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAiC,CAAC;QACtD,IAAI,CAAC,MAAM;YAAE,OAAO,EAAE,CAAC;QAEvB,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAEjC,oDAAoD;QACpD,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;YACnC,OAAO,UAAU,CAAC;QACpB,CAAC;aAAM,IACL,UAAU;YACV,OAAO,UAAU,KAAK,QAAQ;YAC9B,OAAO,IAAI,UAAU,EACrB,CAAC;YACD,OAAO,MAAM,CAAE,UAAiC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAChE,CAAC;QAED,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,gBAAgB,CACrB,eAAgC;QAEhC,MAAM,EAAE,mBAAmB,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,EAAE,GAChE,eAAe,CAAC;QAElB,IAAI,CAAC,mBAAmB,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,OAAO,GAAmC,EAAE,CAAC;QAEnD,IAAI,aAAa,KAAK,SAAS,IAAI,UAAU,IAAI,QAAQ,EAAE,CAAC;YAC1D,gDAAgD;YAChD,OAAO,CAAC,IAAI,CAAC;gBACX,SAAS,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE;gBACxC,SAAS,EAAE,cAAc;gBACzB,KAAK,EAAE,UAAU;aAClB,CAAC,CAAC;YACH,OAAO,CAAC,IAAI,CAAC;gBACX,SAAS,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE;gBACxC,SAAS,EAAE,WAAW;gBACtB,KAAK,EAAE,QAAQ;aAChB,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,aAAa,KAAK,cAAc,IAAI,UAAU,EAAE,CAAC;YAC1D,6CAA6C;YAC7C,OAAO,CAAC,IAAI,CAAC;gBACX,SAAS,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE;gBACxC,SAAS,EAAE,cAAc;gBACzB,KAAK,EAAE,UAAU;aAClB,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,aAAa,KAAK,WAAW,IAAI,QAAQ,EAAE,CAAC;YACrD,4CAA4C;YAC5C,OAAO,CAAC,IAAI,CAAC;gBACX,SAAS,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE;gBACxC,SAAS,EAAE,WAAW;gBACtB,KAAK,EAAE,QAAQ;aAChB,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,aAAa,KAAK,QAAQ,IAAI,UAAU,EAAE,CAAC;YACpD,mBAAmB;YACnB,OAAO,CAAC,IAAI,CAAC;gBACX,SAAS,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE;gBACxC,SAAS,EAAE,QAAQ;gBACnB,KAAK,EAAE,UAAU;aAClB,CAAC,CAAC;QACL,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO;YACL,OAAO;YACP,QAAQ,EAAE,KAAK,EAAE,gCAAgC;SAClD,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,YAAY,CACjB,eAAoD,EACpD,UAAmC;QAEnC,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,OAAO,UAAU,CAAC;QACpB,CAAC;QAED,8DAA8D;QAC9D,IACE,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC;YACtC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,EACjC,CAAC;YACD,OAAO;gBACL,GAAG,eAAe;gBAClB,OAAO,EAAE,CAAC,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,UAAU,CAAC,OAAO,CAAC;aAC7D,CAAC;QACJ,CAAC;QAED,8DAA8D;QAC9D,MAAM,mBAAmB,GAAG,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC;YAChE,CAAC,CAAC,eAAe,CAAC,OAAO;YACzB,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,eAAe,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC;YACvD,CAAC,CAAC,UAAU,CAAC,OAAO;YACpB,CAAC,CAAC,EAAE,CAAC;QAEP,OAAO;YACL,GAAG,eAAe;YAClB,OAAO,EAAE,CAAC,GAAG,mBAAmB,EAAE,GAAG,eAAe,CAAC;YACrD,gDAAgD;YAChD,QAAQ,EAAE,eAAe,CAAC,QAAQ,IAAI,KAAK;SAC5C,CAAC;IACJ,CAAC;CACF"}

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