attio-mcp 0.1.1 → 1.0.0

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

@@ -0,0 +1,172 @@
+/**
+ * People search strategy implementation
+ * Issue #574: Extract people search logic from UniversalSearchService
+ */
+import { SearchType, MatchType, SortType, UniversalResourceType, } from '../../handlers/tool-configs/universal/types.js';
+import { BaseSearchStrategy } from './BaseSearchStrategy.js';
+import { FilterValidationError } from '../../errors/api-errors.js';
+import { createScopedLogger } from '../../utils/logger.js';
+/**
+ * Search strategy for people with advanced filtering, name/email search, and content search
+ */
+export class PeopleSearchStrategy extends BaseSearchStrategy {
+    constructor(dependencies) {
+        super(dependencies);
+    }
+    getResourceType() {
+        return UniversalResourceType.PEOPLE;
+    }
+    supportsAdvancedFiltering() {
+        return true;
+    }
+    supportsQuerySearch() {
+        return true;
+    }
+    async search(params) {
+        const { query, filters, limit, offset, search_type = SearchType.BASIC, fields, match_type = MatchType.PARTIAL, sort = SortType.NAME, timeframeParams, } = params;
+        // Apply timeframe filtering
+        const enhancedFilters = this.applyTimeframeFiltering(filters, timeframeParams);
+        // If we have filters, use advanced search
+        if (enhancedFilters) {
+            return this.searchWithFilters(enhancedFilters, limit, offset);
+        }
+        // If we have a query, handle different search types
+        if (query && query.trim().length > 0) {
+            return this.searchWithQuery(query.trim(), search_type, fields, match_type, sort, limit, offset);
+        }
+        // No query and no filters - return paginated results
+        return this.searchWithoutQuery(limit, offset);
+    }
+    /**
+     * Search people using advanced filters
+     */
+    async searchWithFilters(filters, limit, offset) {
+        if (!this.dependencies.paginatedSearchFunction) {
+            throw new Error('People search function not available');
+        }
+        try {
+            // FilterValidationError will bubble up naturally from searchFn, including for invalid empty filters
+            const paginatedResult = await this.dependencies.paginatedSearchFunction(filters, {
+                limit,
+                offset,
+            });
+            return paginatedResult.results;
+        }
+        catch (error) {
+            // Let FilterValidationError bubble up for proper error handling
+            if (error instanceof FilterValidationError) {
+                throw error;
+            }
+            throw error;
+        }
+    }
+    /**
+     * Search people with a text query
+     */
+    async searchWithQuery(query, searchType, fields, matchType = MatchType.PARTIAL, sort = SortType.NAME, limit, offset) {
+        if (!this.dependencies.paginatedSearchFunction) {
+            throw new Error('People search function not available');
+        }
+        // Auto-detect email-like queries and search email field specifically
+        if (this.looksLikeEmail(query)) {
+            return this.searchByEmail(query, limit, offset);
+        }
+        // Handle different search types
+        if (searchType === SearchType.CONTENT) {
+            return this.searchByContent(query, fields, matchType, sort, limit, offset);
+        }
+        else {
+            return this.searchByNameAndEmail(query, matchType, limit, offset);
+        }
+    }
+    /**
+     * Search people without any query or filters
+     */
+    async searchWithoutQuery(limit, offset) {
+        if (!this.dependencies.paginatedSearchFunction) {
+            throw new Error('People search function not available');
+        }
+        try {
+            const paginatedResult = await this.dependencies.paginatedSearchFunction({ filters: [] }, { limit, offset });
+            return paginatedResult.results;
+        }
+        catch (error) {
+            // If empty filters aren't supported, return empty array rather than failing
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            const log = createScopedLogger('PeopleSearchStrategy', 'searchWithoutQuery');
+            log.warn('People search with empty filters failed, returning empty results', { errorMessage });
+            return [];
+        }
+    }
+    /**
+     * Search people by email address
+     */
+    async searchByEmail(query, limit, offset) {
+        const emailFilters = {
+            filters: [
+                {
+                    attribute: { slug: 'email_addresses' },
+                    condition: 'contains',
+                    value: query,
+                },
+            ],
+        };
+        if (!this.dependencies.paginatedSearchFunction) {
+            throw new Error('People search function not available');
+        }
+        const paginatedResult = await this.dependencies.paginatedSearchFunction(emailFilters, {
+            limit,
+            offset,
+        });
+        return paginatedResult.results;
+    }
+    /**
+     * Search people by content across multiple fields
+     */
+    async searchByContent(query, fields, matchType = MatchType.PARTIAL, sort = SortType.NAME, limit, offset) {
+        // Default content fields for people
+        const searchFields = fields && fields.length > 0
+            ? fields
+            : ['name', 'notes', 'email_addresses', 'job_title'];
+        const contentFilters = this.createContentFilters(query, searchFields, matchType);
+        if (!this.dependencies.paginatedSearchFunction) {
+            throw new Error('People search function not available');
+        }
+        const paginatedResult = await this.dependencies.paginatedSearchFunction(contentFilters, {
+            limit,
+            offset,
+        });
+        // Apply relevance ranking if requested
+        const results = this.applyRelevanceRanking(paginatedResult.results, query, searchFields, sort);
+        return results;
+    }
+    /**
+     * Search people by name and email (basic search)
+     */
+    async searchByNameAndEmail(query, matchType = MatchType.PARTIAL, limit, offset) {
+        const nameEmailFilters = {
+            filters: [
+                {
+                    attribute: { slug: 'name' },
+                    condition: matchType === MatchType.EXACT ? 'equals' : 'contains',
+                    value: query,
+                },
+                {
+                    attribute: { slug: 'email_addresses' },
+                    condition: matchType === MatchType.EXACT ? 'equals' : 'contains',
+                    value: query,
+                },
+            ],
+            matchAny: true, // Use OR logic to match either name or email
+        };
+        if (!this.dependencies.paginatedSearchFunction) {
+            throw new Error('People search function not available');
+        }
+        const paginatedResult = await this.dependencies.paginatedSearchFunction(nameEmailFilters, {
+            limit,
+            offset,
+        });
+        return paginatedResult.results;
+    }
+}
+//# sourceMappingURL=PeopleSearchStrategy.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PeopleSearchStrategy.js","sourceRoot":"","sources":["../../../src/services/search-strategies/PeopleSearchStrategy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,UAAU,EACV,SAAS,EACT,QAAQ,EACR,qBAAqB,GACtB,MAAM,gDAAgD,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,kBAAkB;IAC1D,YAAY,YAAkC;QAC5C,KAAK,CAAC,YAAY,CAAC,CAAC;IACtB,CAAC;IAED,eAAe;QACb,OAAO,qBAAqB,CAAC,MAAM,CAAC;IACtC,CAAC;IAED,yBAAyB;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,mBAAmB;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAA4B;QACvC,MAAM,EACJ,KAAK,EACL,OAAO,EACP,KAAK,EACL,MAAM,EACN,WAAW,GAAG,UAAU,CAAC,KAAK,EAC9B,MAAM,EACN,UAAU,GAAG,SAAS,CAAC,OAAO,EAC9B,IAAI,GAAG,QAAQ,CAAC,IAAI,EACpB,eAAe,GAChB,GAAG,MAAM,CAAC;QAEX,4BAA4B;QAC5B,MAAM,eAAe,GAAG,IAAI,CAAC,uBAAuB,CAClD,OAAO,EACP,eAAe,CAChB,CAAC;QAEF,0CAA0C;QAC1C,IAAI,eAAe,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC,iBAAiB,CAAC,eAAe,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QAChE,CAAC;QAED,oDAAoD;QACpD,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrC,OAAO,IAAI,CAAC,eAAe,CACzB,KAAK,CAAC,IAAI,EAAE,EACZ,WAAW,EACX,MAAM,EACN,UAAU,EACV,IAAI,EACJ,KAAK,EACL,MAAM,CACP,CAAC;QACJ,CAAC;QAED,qDAAqD;QACrD,OAAO,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,iBAAiB,CAC7B,OAAgC,EAChC,KAAc,EACd,MAAe;QAEf,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,uBAAuB,EAAE,CAAC;YAC/C,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QAED,IAAI,CAAC;YACH,oGAAoG;YACpG,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,uBAAuB,CACrE,OAAO,EACP;gBACE,KAAK;gBACL,MAAM;aACP,CACF,CAAC;YACF,OAAO,eAAe,CAAC,OAAO,CAAC;QACjC,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,gEAAgE;YAChE,IAAI,KAAK,YAAY,qBAAqB,EAAE,CAAC;gBAC3C,MAAM,KAAK,CAAC;YACd,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,eAAe,CAC3B,KAAa,EACb,UAAsB,EACtB,MAAiB,EACjB,YAAuB,SAAS,CAAC,OAAO,EACxC,OAAiB,QAAQ,CAAC,IAAI,EAC9B,KAAc,EACd,MAAe;QAEf,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,uBAAuB,EAAE,CAAC;YAC/C,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QAED,qEAAqE;QACrE,IAAI,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QAClD,CAAC;QAED,gCAAgC;QAChC,IAAI,UAAU,KAAK,UAAU,CAAC,OAAO,EAAE,CAAC;YACtC,OAAO,IAAI,CAAC,eAAe,CACzB,KAAK,EACL,MAAM,EACN,SAAS,EACT,IAAI,EACJ,KAAK,EACL,MAAM,CACP,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,CAAC,oBAAoB,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,kBAAkB,CAC9B,KAAc,EACd,MAAe;QAEf,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,uBAAuB,EAAE,CAAC;YAC/C,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QAED,IAAI,CAAC;YACH,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,uBAAuB,CACrE,EAAE,OAAO,EAAE,EAAE,EAAE,EACf,EAAE,KAAK,EAAE,MAAM,EAAE,CAClB,CAAC;YACF,OAAO,eAAe,CAAC,OAAO,CAAC;QACjC,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,4EAA4E;YAC5E,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;YAC3D,MAAM,GAAG,GAAG,kBAAkB,CAC5B,sBAAsB,EACtB,oBAAoB,CACrB,CAAC;YACF,GAAG,CAAC,IAAI,CACN,kEAAkE,EAClE,EAAE,YAAY,EAAE,CACjB,CAAC;YACF,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,aAAa,CACzB,KAAa,EACb,KAAc,EACd,MAAe;QAEf,MAAM,YAAY,GAAG;YACnB,OAAO,EAAE;gBACP;oBACE,SAAS,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE;oBACtC,SAAS,EAAE,UAAU;oBACrB,KAAK,EAAE,KAAK;iBACb;aACF;SACF,CAAC;QAEF,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,uBAAuB,EAAE,CAAC;YAC/C,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QAED,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,uBAAuB,CACrE,YAAY,EACZ;YACE,KAAK;YACL,MAAM;SACP,CACF,CAAC;QACF,OAAO,eAAe,CAAC,OAAO,CAAC;IACjC,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,eAAe,CAC3B,KAAa,EACb,MAAiB,EACjB,YAAuB,SAAS,CAAC,OAAO,EACxC,OAAiB,QAAQ,CAAC,IAAI,EAC9B,KAAc,EACd,MAAe;QAEf,oCAAoC;QACpC,MAAM,YAAY,GAChB,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;YACzB,CAAC,CAAC,MAAM;YACR,CAAC,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,iBAAiB,EAAE,WAAW,CAAC,CAAC;QAExD,MAAM,cAAc,GAAG,IAAI,CAAC,oBAAoB,CAC9C,KAAK,EACL,YAAY,EACZ,SAAS,CACV,CAAC;QAEF,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,uBAAuB,EAAE,CAAC;YAC/C,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QAED,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,uBAAuB,CACrE,cAAc,EACd;YACE,KAAK;YACL,MAAM;SACP,CACF,CAAC;QAEF,uCAAuC;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,qBAAqB,CACxC,eAAe,CAAC,OAAO,EACvB,KAAK,EACL,YAAY,EACZ,IAAI,CACL,CAAC;QACF,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,oBAAoB,CAChC,KAAa,EACb,YAAuB,SAAS,CAAC,OAAO,EACxC,KAAc,EACd,MAAe;QAEf,MAAM,gBAAgB,GAAG;YACvB,OAAO,EAAE;gBACP;oBACE,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;oBAC3B,SAAS,EAAE,SAAS,KAAK,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU;oBAChE,KAAK,EAAE,KAAK;iBACb;gBACD;oBACE,SAAS,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE;oBACtC,SAAS,EAAE,SAAS,KAAK,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU;oBAChE,KAAK,EAAE,KAAK;iBACb;aACF;YACD,QAAQ,EAAE,IAAI,EAAE,6CAA6C;SAC9D,CAAC;QAEF,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,uBAAuB,EAAE,CAAC;YAC/C,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QAED,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,uBAAuB,CACrE,gBAAgB,EAChB;YACE,KAAK;YACL,MAAM;SACP,CACF,CAAC;QACF,OAAO,eAAe,CAAC,OAAO,CAAC;IACjC,CAAC;CACF"}

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

@@ -0,0 +1,38 @@
+/**
+ * Task search strategy implementation
+ * Issue #574: Extract task search logic from UniversalSearchService
+ */
+import { AttioRecord } from '../../types/attio.js';
+import { BaseSearchStrategy } from './BaseSearchStrategy.js';
+import { SearchStrategyParams, StrategyDependencies } from './interfaces.js';
+/**
+ * Search strategy for tasks with performance optimization, caching, and content search support
+ */
+export declare class TaskSearchStrategy extends BaseSearchStrategy {
+    constructor(dependencies: StrategyDependencies);
+    getResourceType(): string;
+    supportsAdvancedFiltering(): boolean;
+    supportsQuerySearch(): boolean;
+    search(params: SearchStrategyParams): Promise<AttioRecord[]>;
+    /**
+     * Search tasks with performance optimization, caching, and content search support
+     *
+     * PERFORMANCE-OPTIMIZED TASKS PAGINATION
+     *
+     * The Attio Tasks API does not support native pagination parameters.
+     * This implementation uses smart caching and performance monitoring to
+     * minimize the performance impact of loading all tasks.
+     *
+     * Optimizations:
+     * - Smart caching with 30-second TTL to avoid repeated full loads
+     * - Performance warnings for large datasets (>500 tasks)
+     * - Early termination for large offsets
+     * - Memory usage monitoring and cleanup
+     */
+    private searchTasks;
+    /**
+     * Apply content search filtering to tasks
+     */
+    private applyContentSearch;
+}
+//# sourceMappingURL=TaskSearchStrategy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TaskSearchStrategy.d.ts","sourceRoot":"","sources":["../../../src/services/search-strategies/TaskSearchStrategy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAOnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAU7E;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,kBAAkB;gBAC5C,YAAY,EAAE,oBAAoB;IAI9C,eAAe,IAAI,MAAM;IAIzB,yBAAyB,IAAI,OAAO;IAIpC,mBAAmB,IAAI,OAAO;IAIxB,MAAM,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IA4BlE;;;;;;;;;;;;;;OAcG;YACW,WAAW;IA4GzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAgC3B"}

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

@@ -0,0 +1,146 @@
+/**
+ * Task search strategy implementation
+ * Issue #574: Extract task search logic from UniversalSearchService
+ */
+import { SearchType, MatchType, SortType, UniversalResourceType, } from '../../handlers/tool-configs/universal/types.js';
+import { BaseSearchStrategy } from './BaseSearchStrategy.js';
+import { performance } from 'perf_hooks';
+import { SearchUtilities } from '../search-utilities/SearchUtilities.js';
+import { createScopedLogger, OperationType } from '../../utils/logger.js';
+// Import performance tracking and caching services
+import { enhancedPerformanceTracker } from '../../middleware/performance-enhanced.js';
+import { CachingService } from '../CachingService.js';
+import { UniversalUtilityService } from '../UniversalUtilityService.js';
+/**
+ * Search strategy for tasks with performance optimization, caching, and content search support
+ */
+export class TaskSearchStrategy extends BaseSearchStrategy {
+    constructor(dependencies) {
+        super(dependencies);
+    }
+    getResourceType() {
+        return UniversalResourceType.TASKS;
+    }
+    supportsAdvancedFiltering() {
+        return false; // Tasks only support basic search
+    }
+    supportsQuerySearch() {
+        return true; // Tasks support content search via applyContentSearch method
+    }
+    async search(params) {
+        const { query, limit, offset, search_type = SearchType.BASIC, fields, match_type = MatchType.PARTIAL, sort = SortType.NAME, } = params;
+        // Extract performance tracking IDs from parameters (passed via dependencies)
+        const perfId = 'tasks_search'; // Default fallback
+        const apiStart = performance.now();
+        return this.searchTasks(perfId, apiStart, query, limit, offset, search_type, fields, match_type, sort);
+    }
+    /**
+     * Search tasks with performance optimization, caching, and content search support
+     *
+     * PERFORMANCE-OPTIMIZED TASKS PAGINATION
+     *
+     * The Attio Tasks API does not support native pagination parameters.
+     * This implementation uses smart caching and performance monitoring to
+     * minimize the performance impact of loading all tasks.
+     *
+     * Optimizations:
+     * - Smart caching with 30-second TTL to avoid repeated full loads
+     * - Performance warnings for large datasets (>500 tasks)
+     * - Early termination for large offsets
+     * - Memory usage monitoring and cleanup
+     */
+    async searchTasks(perfId, apiStart, query, limit, offset, search_type = SearchType.BASIC, fields, match_type = MatchType.PARTIAL, sort = SortType.NAME) {
+        const log = createScopedLogger('TaskSearchStrategy', 'tasks_search', OperationType.DATA_PROCESSING);
+        // Use CachingService for tasks data management
+        const loadTasksData = async () => {
+            try {
+                if (!this.dependencies.taskFunction) {
+                    throw new Error('Tasks list function not available');
+                }
+                const tasksList = await this.dependencies.taskFunction();
+                // Convert tasks to records and ensure it's always an array
+                if (!Array.isArray(tasksList)) {
+                    log.warn('TASKS API WARNING: listTasks() returned non-array value', {
+                        returnedType: typeof tasksList,
+                    });
+                    return [];
+                }
+                else {
+                    // Convert AttioTask[] to AttioRecord[]
+                    return tasksList.map(UniversalUtilityService.convertTaskToRecord);
+                }
+            }
+            catch (error) {
+                log.error('Failed to load tasks from API', error);
+                return []; // Fallback to empty array
+            }
+        };
+        const { data: tasks, fromCache } = await CachingService.getOrLoadTasks(loadTasksData);
+        // Performance warning for large datasets
+        if (!fromCache && tasks.length > 500) {
+            log.warn('PERFORMANCE WARNING: Large tasks load', {
+                taskCount: tasks.length,
+                recommendation: 'Consider requesting Attio API pagination support for tasks endpoint.',
+            });
+        }
+        // Log performance metrics
+        if (!fromCache) {
+            enhancedPerformanceTracker.markTiming(perfId, 'attioApi', performance.now() - apiStart);
+        }
+        else {
+            enhancedPerformanceTracker.markTiming(perfId, 'other', 1);
+        }
+        // Handle empty dataset cleanly
+        if (tasks.length === 0) {
+            return []; // No warning for empty datasets
+        }
+        // Apply content search filtering if requested
+        let filteredTasks = tasks;
+        if (search_type === SearchType.CONTENT && query && query.trim()) {
+            filteredTasks = this.applyContentSearch(tasks, query.trim(), fields, match_type, sort);
+        }
+        // Smart pagination with early termination for unreasonable offsets
+        const start = offset || 0;
+        const requestedLimit = limit || 10;
+        // Performance optimization: Don't process if offset exceeds dataset
+        if (start >= filteredTasks.length) {
+            log.info('Tasks pagination offset exceeds dataset size', {
+                offset: start,
+                filteredSize: filteredTasks.length,
+                action: 'returning empty results',
+            });
+            return [];
+        }
+        else {
+            const end = Math.min(start + requestedLimit, filteredTasks.length);
+            const paginatedTasks = filteredTasks.slice(start, end);
+            // Log pagination performance metrics
+            enhancedPerformanceTracker.markTiming(perfId, 'serialization', fromCache ? 1 : performance.now() - apiStart);
+            return paginatedTasks;
+        }
+    }
+    /**
+     * Apply content search filtering to tasks
+     */
+    applyContentSearch(tasks, query, fields, matchType = MatchType.PARTIAL, sort = SortType.NAME) {
+        const searchFields = fields || ['content', 'title', 'content_plaintext'];
+        const queryLower = query.toLowerCase();
+        let filteredTasks = tasks.filter((task) => {
+            return searchFields.some((field) => {
+                const fieldValue = SearchUtilities.getTaskFieldValue(task, field);
+                if (matchType === MatchType.EXACT) {
+                    return fieldValue.toLowerCase() === queryLower;
+                }
+                else {
+                    return fieldValue.toLowerCase().includes(queryLower);
+                }
+            });
+        });
+        // Apply relevance ranking if requested
+        if (sort === SortType.RELEVANCE) {
+            filteredTasks = SearchUtilities.rankByRelevance(filteredTasks, query, searchFields);
+        }
+        return filteredTasks;
+    }
+}
+//# sourceMappingURL=TaskSearchStrategy.js.map

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

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

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

@@ -0,0 +1,11 @@
+/**
+ * Search strategies index file
+ * Issue #574: Export all search strategy implementations
+ */
+export type { ISearchStrategy, SearchStrategyParams, StrategyDependencies, TimeframeParams, } from './interfaces.js';
+export { BaseSearchStrategy } from './BaseSearchStrategy.js';
+export { CompanySearchStrategy } from './CompanySearchStrategy.js';
+export { PeopleSearchStrategy } from './PeopleSearchStrategy.js';
+export { TaskSearchStrategy } from './TaskSearchStrategy.js';
+export { ListSearchStrategy } from './ListSearchStrategy.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/search-strategies/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EACV,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,GAChB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC"}

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

@@ -0,0 +1,10 @@
+/**
+ * Search strategies index file
+ * Issue #574: Export all search strategy implementations
+ */
+export { BaseSearchStrategy } from './BaseSearchStrategy.js';
+export { CompanySearchStrategy } from './CompanySearchStrategy.js';
+export { PeopleSearchStrategy } from './PeopleSearchStrategy.js';
+export { TaskSearchStrategy } from './TaskSearchStrategy.js';
+export { ListSearchStrategy } from './ListSearchStrategy.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/search-strategies/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC"}

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":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,EACL,UAAU,EACV,SAAS,EACT,QAAQ,EACT,MAAM,gDAAgD,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,cAAc,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;CACrE;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAE7D;;OAEG;IACH,eAAe,IAAI,MAAM,CAAC;IAE1B;;OAEG;IACH,yBAAyB,IAAI,OAAO,CAAC;IAErC;;OAEG;IACH,mBAAmB,IAAI,OAAO,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IAEnC,sBAAsB,CAAC,EACnB,CAAC,CACC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,KAAK,CAAC,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,KACZ,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,GAC5B,IAAI,CAAC;IACT,uBAAuB,CAAC,EACpB,CAAC,CACC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,UAAU,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,KAC5C,OAAO,CAAC;QAAE,OAAO,EAAE,WAAW,EAAE,CAAA;KAAE,CAAC,CAAC,GACzC,IAAI,CAAC;IACT,YAAY,CAAC,EAAE,CACb,KAAK,CAAC,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,KACZ,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAC1B,YAAY,CAAC,EAAE,CACb,MAAM,CAAC,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,MAAM,KACd,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAG1B,gBAAgB,CAAC,EAAE,CACjB,MAAM,EAAE,eAAe,KACpB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACpC,YAAY,CAAC,EAAE,CACb,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC7C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,eAAe,CAAC,EAAE,CAChB,OAAO,EAAE,WAAW,EAAE,EACtB,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,MAAM,EAAE,KACnB,WAAW,EAAE,CAAC;IACnB,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CAChE"}

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