@iflow-mcp/attio-mcp 1.3.6

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

@@ -0,0 +1,224 @@
+/**
+ * Note search strategy implementation
+ * Issue #888: Fix notes search - notes cannot be found by title/content
+ *
+ * **IMPORTANT API LIMITATION**:
+ * The Attio Notes API /v2/notes endpoint returns an empty array when called without filters.
+ * Testing with curl confirmed: GET /v2/notes returns {"data": []}
+ * The API requires parent_object and/or parent_record_id filters to return any notes.
+ *
+ * **What Works**:
+ * - list-notes tool with parent record filtering (e.g., list all notes on a company)
+ * - Content search within notes for a specific parent record
+ *
+ * **What Doesn't Work**:
+ * - Workspace-wide note search without parent filters
+ * - Global search like "find all notes containing 'demo'" across all records
+ *
+ * Recommendation: Request Attio to add workspace-wide notes endpoint or search capability.
+ */
+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';
+// Performance warning threshold for large note datasets
+const NOTES_PERFORMANCE_WARNING_THRESHOLD = 2000;
+/**
+ * Search strategy for notes with performance optimization, caching, and content search support
+ *
+ * IMPLEMENTATION NOTE:
+ * The Attio Notes API (/notes endpoint) does not support native text search.
+ * It only supports filtering by parent_object and parent_record_id.
+ * Therefore, we fetch all notes and apply client-side filtering for search queries.
+ */
+export class NoteSearchStrategy extends BaseSearchStrategy {
+    constructor(dependencies) {
+        super(dependencies);
+    }
+    getResourceType() {
+        return UniversalResourceType.NOTES;
+    }
+    supportsAdvancedFiltering() {
+        return false; // Notes only support basic search
+    }
+    supportsQuerySearch() {
+        return true; // Notes 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, filters, } = params;
+        // Extract performance tracking IDs from parameters (passed via dependencies)
+        const perfId = 'notes_search'; // Default fallback
+        const apiStart = performance.now();
+        return this.searchNotes(perfId, apiStart, query, limit, offset, search_type, fields, match_type, sort, filters);
+    }
+    /**
+     * Search notes with performance optimization, caching, and content search support
+     *
+     * PERFORMANCE-OPTIMIZED NOTES PAGINATION
+     *
+     * The Attio Notes API does not support native text search or advanced filtering.
+     * This implementation uses smart caching and performance monitoring to
+     * minimize the performance impact of loading all notes.
+     *
+     * Optimizations:
+     * - Smart caching with 30-second TTL to avoid repeated full loads
+     * - Performance warnings for large datasets (>500 notes)
+     * - Early termination for large offsets
+     * - Memory usage monitoring and cleanup
+     */
+    async searchNotes(perfId, apiStart, query, limit, offset, search_type = SearchType.BASIC, fields, match_type = MatchType.PARTIAL, sort = SortType.NAME, filters) {
+        const log = createScopedLogger('NoteSearchStrategy', 'notes_search', OperationType.DATA_PROCESSING);
+        // Use CachingService for notes data management
+        const loadNotesData = async () => {
+            try {
+                if (!this.dependencies.noteFunction) {
+                    throw new Error('Notes list function not available');
+                }
+                // Build query params for filtering if provided
+                const queryParams = {};
+                if (filters) {
+                    if (filters.parent_object || filters.linked_record_type) {
+                        queryParams.parent_object =
+                            filters.parent_object || filters.linked_record_type;
+                    }
+                    if (filters.parent_record_id || filters.linked_record_id) {
+                        queryParams.parent_record_id =
+                            filters.parent_record_id || filters.linked_record_id;
+                    }
+                }
+                const notesResponse = await this.dependencies.noteFunction(queryParams);
+                const notesList = notesResponse.data || [];
+                // Convert notes to records and ensure it's always an array
+                if (!Array.isArray(notesList)) {
+                    log.warn('NOTES API WARNING: listNotes() returned non-array value', {
+                        returnedType: typeof notesList,
+                    });
+                    return [];
+                }
+                else {
+                    // Convert AttioNote[] to AttioRecord[]
+                    // Cast to AttioNote[] since we know the API returns notes
+                    return notesList.map((note) => this.convertNoteToRecord(note));
+                }
+            }
+            catch (error) {
+                log.error('Failed to load notes from API', error);
+                return []; // Fallback to empty array
+            }
+        };
+        // Generate cache key based on parent filters to prevent collisions
+        const cacheKey = CachingService.getNotesListCacheKey(filters);
+        const { data: notes, fromCache } = await CachingService.getOrLoadNotes(loadNotesData, cacheKey);
+        // Performance warning for large datasets
+        if (!fromCache && notes.length > NOTES_PERFORMANCE_WARNING_THRESHOLD) {
+            log.warn('PERFORMANCE WARNING: Large notes load', {
+                noteCount: notes.length,
+                threshold: NOTES_PERFORMANCE_WARNING_THRESHOLD,
+                recommendation: 'Consider requesting Attio API pagination support for notes endpoint.',
+            });
+        }
+        // Log performance metrics
+        if (!fromCache) {
+            enhancedPerformanceTracker.markTiming(perfId, 'attioApi', performance.now() - apiStart);
+        }
+        else {
+            enhancedPerformanceTracker.markTiming(perfId, 'other', 1);
+        }
+        // Handle empty dataset cleanly
+        if (notes.length === 0) {
+            return []; // No warning for empty datasets
+        }
+        // Apply content search filtering if requested
+        let filteredNotes = notes;
+        if (search_type === SearchType.CONTENT && query && query.trim()) {
+            filteredNotes = this.applyContentSearch(notes, query.trim(), fields, match_type, sort);
+        }
+        else if (query && query.trim()) {
+            // For BASIC search type, also apply content filtering
+            filteredNotes = this.applyContentSearch(notes, 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 >= filteredNotes.length) {
+            log.info('Notes pagination offset exceeds dataset size', {
+                offset: start,
+                filteredSize: filteredNotes.length,
+                action: 'returning empty results',
+            });
+            return [];
+        }
+        else {
+            const end = Math.min(start + requestedLimit, filteredNotes.length);
+            const paginatedNotes = filteredNotes.slice(start, end);
+            // Log pagination performance metrics
+            enhancedPerformanceTracker.markTiming(perfId, 'serialization', fromCache ? 1 : performance.now() - apiStart);
+            return paginatedNotes;
+        }
+    }
+    /**
+     * Apply content search filtering to notes
+     */
+    applyContentSearch(notes, query, fields, matchType = MatchType.PARTIAL, sort = SortType.NAME) {
+        const searchFields = fields || [
+            'title',
+            'content_markdown',
+            'content_plaintext',
+        ];
+        const queryLower = query.toLowerCase();
+        let filteredNotes = notes.filter((note) => {
+            return searchFields.some((field) => {
+                const fieldValue = SearchUtilities.getNoteFieldValue(note, field);
+                if (matchType === MatchType.EXACT) {
+                    return fieldValue.toLowerCase() === queryLower;
+                }
+                else {
+                    return fieldValue.toLowerCase().includes(queryLower);
+                }
+            });
+        });
+        // Apply relevance ranking if requested
+        if (sort === SortType.RELEVANCE) {
+            filteredNotes = SearchUtilities.rankByRelevance(filteredNotes, query, searchFields);
+        }
+        return filteredNotes;
+    }
+    /**
+     * Convert AttioNote to AttioRecord format
+     */
+    convertNoteToRecord(note) {
+        // Handle id field which can be string or AttioNoteIdentifier
+        const noteId = typeof note.id === 'string' ? note.id : note.id?.note_id || '';
+        // Extract content fields - API returns content_markdown, content_plaintext, or content
+        // Match the normalization logic from src/objects/notes.ts:normalizeNoteResponse
+        const contentMarkdown = (note.content_markdown ??
+            note.content ??
+            '');
+        const contentPlaintext = (note.content_plaintext ??
+            note.content ??
+            '');
+        // Return properly typed record satisfying AttioRecord interface
+        const record = {
+            id: {
+                record_id: noteId,
+                note_id: noteId,
+            },
+            values: {
+                title: note.title || '',
+                content_markdown: contentMarkdown,
+                content_plaintext: contentPlaintext,
+                parent_object: note.parent_object || '',
+                parent_record_id: note.parent_record_id || '',
+                created_at: note.created_at || '',
+                created_by_actor: note.created_by_actor,
+            },
+        };
+        return record;
+    }
+}
+//# sourceMappingURL=NoteSearchStrategy.js.map

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

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

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

@@ -0,0 +1,42 @@
+/**
+ * People search strategy implementation
+ * Issue #574: Extract people search logic from UniversalSearchService
+ */
+import { AttioRecord } from '../../types/attio.js';
+import { BaseSearchStrategy } from './BaseSearchStrategy.js';
+import { SearchStrategyParams, StrategyDependencies } from './interfaces.js';
+/**
+ * Search strategy for people with advanced filtering, name/email search, and content search
+ */
+export declare class PeopleSearchStrategy extends BaseSearchStrategy {
+    constructor(dependencies: StrategyDependencies);
+    getResourceType(): string;
+    supportsAdvancedFiltering(): boolean;
+    supportsQuerySearch(): boolean;
+    search(params: SearchStrategyParams): Promise<AttioRecord[]>;
+    /**
+     * Search people using advanced filters
+     */
+    private searchWithFilters;
+    /**
+     * Search people with a text query
+     */
+    private searchWithQuery;
+    /**
+     * Search people without any query or filters
+     */
+    private searchWithoutQuery;
+    /**
+     * Search people by email address
+     */
+    private searchByEmail;
+    /**
+     * Search people by content across multiple fields
+     */
+    private searchByContent;
+    /**
+     * Search people by name and email (basic search)
+     */
+    private searchByNameAndEmail;
+}
+//# sourceMappingURL=PeopleSearchStrategy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PeopleSearchStrategy.d.ts","sourceRoot":"","sources":["../../../src/services/search-strategies/PeopleSearchStrategy.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;AAK7E;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,kBAAkB;gBAC9C,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;IAyClE;;OAEG;YACW,iBAAiB;IA4B/B;;OAEG;YACW,eAAe;IA2C7B;;OAEG;YACW,kBAAkB;IAsBhC;;OAEG;YACW,aAAa;IA6B3B;;OAEG;YACW,eAAe;IA0C7B;;OAEG;YACW,oBAAoB;CAmCnC"}

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

@@ -0,0 +1,176 @@
+/**
+ * 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';
+/**
+ * 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');
+        }
+        // Handle different search types
+        if (searchType === SearchType.CONTENT) {
+            return this.searchByContent(query, fields, matchType, sort, limit, offset);
+        }
+        else {
+            // For simple text queries without special fields/filters,
+            // use searchObject which includes fast path optimization
+            const { searchObject } = await import('../../api/operations/search.js');
+            const { ResourceType } = await import('../../types/attio.js');
+            // Calculate total records needed: offset + limit
+            const start = offset || 0;
+            const effectiveLimit = limit ? start + limit : undefined;
+            const results = await searchObject(ResourceType.PEOPLE, query, {
+                limit: effectiveLimit,
+            });
+            // Apply offset to slice the results
+            const end = limit ? start + limit : undefined;
+            return results.slice(start, end);
+        }
+    }
+    /**
+     * Search people without any query or filters
+     */
+    async searchWithoutQuery(limit, offset) {
+        if (!this.dependencies.paginatedSearchFunction) {
+            throw new Error('People search function not available');
+        }
+        return this.handleEmptyFilters(async (filters, limitArg, offsetArg) => {
+            const paginatedResult = await this.dependencies
+                .paginatedSearchFunction(filters, {
+                limit: limitArg,
+                offset: offsetArg,
+            });
+            return paginatedResult.results;
+        }, limit, offset);
+    }
+    /**
+     * 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":"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"}

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