attio-mcp 0.1.0

package/dist/utils/record-utils.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Utility functions for working with Attio records and responses
+ * Provides functions for processing list entries, extracting record information,
+ * and interacting with the Attio API.
+ */
+import { AttioListEntry } from '../types/attio.js';
+import { transformFiltersToApiFormat, createDateRangeFilter, createCreatedDateFilter, createModifiedDateFilter, createLastInteractionFilter, createActivityFilter, createNumericFilter } from './filters/index.js';
+export { transformFiltersToApiFormat, createDateRangeFilter, createCreatedDateFilter, createModifiedDateFilter, createLastInteractionFilter, createActivityFilter, createNumericFilter, };
+export declare const API_PARAMS: {
+    EXPAND: string;
+    RECORD: string;
+    LIMIT: string;
+    OFFSET: string;
+    LIST_ID: string;
+};
+export declare const ATTRIBUTE_SLUGS: {
+    CREATED_AT: string;
+    UPDATED_AT: string;
+    LAST_INTERACTION: string;
+    INTERACTION_TYPE: string;
+    EMAIL: string;
+    PHONE: string;
+    NAME: string;
+    WEBSITE: string;
+    INDUSTRY: string;
+    REVENUE: string;
+    EMPLOYEE_COUNT: string;
+    LIST_ID: string;
+    NOTE_CONTENT: string;
+    RELATIONSHIP: string;
+};
+/**
+ * Extracts and ensures record_id is properly populated in list entries
+ *
+ * @param entries - Raw list entries from API response
+ * @returns Processed list entries with record_id correctly populated
+ */
+export declare function processListEntries(entries: AttioListEntry[]): AttioListEntry[];
+/**
+ * Safely extracts record name and type from a list entry if available
+ *
+ * @param entry - List entry that may contain record data
+ * @returns An object with record name and type or empty values if not available
+ */
+export declare function getRecordNameFromEntry(entry: AttioListEntry): {
+    name: string;
+    type: string;
+};
+/**
+ * Creates a path-based filter for filtering list entries by parent record properties
+ *
+ * This function constructs a filter that follows paths through related objects,
+ * which is necessary for filtering list entries based on properties of their parent records.
+ *
+ * @param listSlug - The slug of the list (either the API slug or list ID)
+ * @param parentObjectType - The type of the parent record (e.g., 'companies', 'people')
+ * @param parentAttributeSlug - The attribute of the parent record to filter by
+ * @param condition - The filter condition to apply
+ * @param value - The value to filter by
+ * @returns A filter object compatible with the Attio API for path-based filtering
+ *
+ * @example
+ * // Filter for companies in a list named "prospects" that have "Tech" in their industry
+ * const filter = createPathBasedFilter('prospects', 'companies', 'industry', 'contains', 'Tech');
+ *
+ * @example
+ * // Filter for people in a list with ID "list_12345" who have an email from apple.com
+ * const filter = createPathBasedFilter('list_12345', 'people', 'email_addresses', 'contains', '@apple.com');
+ */
+export declare function createPathBasedFilter(listSlug: string, parentObjectType: string, parentAttributeSlug: string, condition: string, value: any): {
+    path: string[][];
+    constraints: Record<string, any>;
+};
+//# sourceMappingURL=record-utils.d.ts.map

package/dist/utils/record-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-utils.d.ts","sourceRoot":"","sources":["../../src/utils/record-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EACL,2BAA2B,EAC3B,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,2BAA2B,EAC3B,oBAAoB,EACpB,mBAAmB,EAGpB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,2BAA2B,EAC3B,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,2BAA2B,EAC3B,oBAAoB,EACpB,mBAAmB,GACpB,CAAC;AAGF,eAAO,MAAM,UAAU;;;;;;CAMtB,CAAC;AAGF,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;CAAoB,CAAC;AAEjD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,cAAc,EAAE,GACxB,cAAc,EAAE,CA6JlB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,cAAc,GAAG;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CA8CA;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,MAAM,EACxB,mBAAmB,EAAE,MAAM,EAC3B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,GAAG,GACT;IAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAAE,CA+ExD"}

package/dist/utils/record-utils.js

@@ -0,0 +1,312 @@
+import { transformFiltersToApiFormat, createDateRangeFilter, createCreatedDateFilter, createModifiedDateFilter, createLastInteractionFilter, createActivityFilter, createNumericFilter, FILTER_ATTRIBUTES, } from './filters/index.js';
+// Re-export filter utilities for backwards compatibility
+export { transformFiltersToApiFormat, createDateRangeFilter, createCreatedDateFilter, createModifiedDateFilter, createLastInteractionFilter, createActivityFilter, createNumericFilter, };
+// API parameter constants for better maintainability
+export const API_PARAMS = {
+    EXPAND: 'expand',
+    RECORD: 'record',
+    LIMIT: 'limit',
+    OFFSET: 'offset',
+    LIST_ID: 'list_id',
+};
+// Re-export attribute slugs for backwards compatibility
+export const ATTRIBUTE_SLUGS = FILTER_ATTRIBUTES;
+/**
+ * Extracts and ensures record_id is properly populated in list entries
+ *
+ * @param entries - Raw list entries from API response
+ * @returns Processed list entries with record_id correctly populated
+ */
+export function processListEntries(entries) {
+    return entries.map((entry) => {
+        // Debug logging in development mode
+        if (process.env.NODE_ENV === 'development') {
+            console.log(`[processListEntries] Processing entry:`, {
+                entryId: entry.id?.entry_id || 'unknown',
+                hasRecordId: !!entry.record_id,
+                hasRecord: !!entry.record,
+                hasParentRecordId: !!entry.parent_record_id,
+                valueKeys: entry.values ? Object.keys(entry.values) : [],
+            });
+        }
+        // If record_id is already defined and non-empty, no processing needed
+        if (entry.record_id &&
+            typeof entry.record_id === 'string' &&
+            entry.record_id.trim() !== '') {
+            return entry;
+        }
+        // Enhanced record_id extraction from multiple possible locations
+        let recordId;
+        // Option 1: Direct parent_record_id property
+        if (entry.parent_record_id) {
+            recordId = entry.parent_record_id;
+        }
+        // Option 2: Nested in record object
+        else if (entry.record?.id?.record_id) {
+            recordId = entry.record.id.record_id;
+        }
+        // Option 3: Nested in values.record_id
+        else if (entry.values &&
+            typeof entry.values === 'object' &&
+            'record_id' in entry.values) {
+            const recordIdValue = entry.values.record_id;
+            if (Array.isArray(recordIdValue) && recordIdValue.length > 0) {
+                // Handle array of values with possible value property
+                if (recordIdValue[0].value) {
+                    recordId = recordIdValue[0].value;
+                }
+                else if (typeof recordIdValue[0] === 'string') {
+                    recordId = recordIdValue[0];
+                }
+            }
+            else if (typeof recordIdValue === 'string') {
+                recordId = recordIdValue;
+            }
+        }
+        // Option 4: Nested in values.record
+        else if (entry.values &&
+            typeof entry.values === 'object' &&
+            'record' in entry.values) {
+            const valuesWithRecord = entry.values;
+            if (valuesWithRecord.record?.id?.record_id) {
+                recordId = valuesWithRecord.record.id.record_id;
+            }
+        }
+        // Option 5: Check for reference_id property
+        else if (entry.reference_id) {
+            recordId = entry.reference_id;
+        }
+        // Option 6: Check for object_id property
+        else if (entry.object_id) {
+            recordId = entry.object_id;
+        }
+        // Option 7: Search all properties for anything ending with _record_id
+        else {
+            const possibleKeys = Object.keys(entry);
+            for (const key of possibleKeys) {
+                if (key.endsWith('_record_id') &&
+                    typeof entry[key] === 'string' &&
+                    entry[key]) {
+                    recordId = entry[key];
+                    break;
+                }
+            }
+        }
+        // Option 8: If record object exists, look for record.reference_id or record.record_id
+        if (!recordId && entry.record) {
+            if (entry.record.reference_id) {
+                recordId = entry.record.reference_id;
+            }
+            else if (entry.record.record_id) {
+                recordId = entry.record.record_id;
+            }
+            else if (entry.record.id) {
+                // Various id object patterns
+                const idObj = entry.record.id;
+                if (typeof idObj === 'string') {
+                    recordId = idObj;
+                }
+                else if (idObj.record_id) {
+                    recordId = idObj.record_id;
+                }
+                else if (idObj.id && typeof idObj.id === 'string') {
+                    recordId = idObj.id;
+                }
+                else if (idObj.reference_id &&
+                    typeof idObj.reference_id === 'string') {
+                    recordId = idObj.reference_id;
+                }
+            }
+        }
+        // If a record_id was found, return updated entry
+        if (recordId) {
+            if (process.env.NODE_ENV === 'development') {
+                console.log(`[processListEntries] Found record_id: ${recordId} for entry ${entry.id?.entry_id || 'unknown'}`);
+            }
+            return {
+                ...entry,
+                record_id: recordId,
+            };
+        }
+        // Additional fallback: Check if record has a uri property
+        if (entry.record?.uri) {
+            const uriParts = entry.record.uri.split('/');
+            if (uriParts.length > 0) {
+                recordId = uriParts[uriParts.length - 1];
+                if (process.env.NODE_ENV === 'development') {
+                    console.log(`[processListEntries] Extracted record_id ${recordId} from URI: ${entry.record.uri}`);
+                }
+                return {
+                    ...entry,
+                    record_id: recordId,
+                };
+            }
+        }
+        // Unable to find record_id, log warning and return entry unchanged
+        if (process.env.NODE_ENV === 'development') {
+            console.warn(`[processListEntries] Could not extract record_id for entry ${entry.id?.entry_id || 'unknown'}`);
+        }
+        // Return entry unchanged if no record_id found
+        return entry;
+    });
+}
+/**
+ * Safely extracts record name and type from a list entry if available
+ *
+ * @param entry - List entry that may contain record data
+ * @returns An object with record name and type or empty values if not available
+ */
+export function getRecordNameFromEntry(entry) {
+    const defaultResult = { name: '', type: '' };
+    // If no record data is available, return default
+    if (!entry.record || !entry.record.values) {
+        return defaultResult;
+    }
+    // Try to determine the record type based on available fields
+    // Companies typically have industry or website fields, people typically have email or phone
+    const isPerson = 'email' in entry.record.values || 'phone' in entry.record.values;
+    const isCompany = 'industry' in entry.record.values || 'website' in entry.record.values;
+    // Set the record type based on detected fields
+    let recordType = '';
+    if (isPerson && !isCompany) {
+        recordType = 'Person';
+    }
+    else if (isCompany && !isPerson) {
+        recordType = 'Company';
+    }
+    else if (entry.record.object_slug) {
+        // If we have an object_slug, use it to determine type
+        recordType =
+            entry.record.object_slug === 'people'
+                ? 'Person'
+                : entry.record.object_slug === 'companies'
+                    ? 'Company'
+                    : '';
+    }
+    // Extract name from the record values
+    const nameValues = entry.record.values.name;
+    let recordName = '';
+    if (Array.isArray(nameValues) &&
+        nameValues.length > 0 &&
+        'value' in nameValues[0]) {
+        recordName = nameValues[0].value || '';
+    }
+    return {
+        name: recordName,
+        type: recordType,
+    };
+}
+/**
+ * Creates a path-based filter for filtering list entries by parent record properties
+ *
+ * This function constructs a filter that follows paths through related objects,
+ * which is necessary for filtering list entries based on properties of their parent records.
+ *
+ * @param listSlug - The slug of the list (either the API slug or list ID)
+ * @param parentObjectType - The type of the parent record (e.g., 'companies', 'people')
+ * @param parentAttributeSlug - The attribute of the parent record to filter by
+ * @param condition - The filter condition to apply
+ * @param value - The value to filter by
+ * @returns A filter object compatible with the Attio API for path-based filtering
+ *
+ * @example
+ * // Filter for companies in a list named "prospects" that have "Tech" in their industry
+ * const filter = createPathBasedFilter('prospects', 'companies', 'industry', 'contains', 'Tech');
+ *
+ * @example
+ * // Filter for people in a list with ID "list_12345" who have an email from apple.com
+ * const filter = createPathBasedFilter('list_12345', 'people', 'email_addresses', 'contains', '@apple.com');
+ */
+export function createPathBasedFilter(listSlug, parentObjectType, parentAttributeSlug, condition, value) {
+    // Create path array for drilling down through objects
+    // First path element is [listSlug, "parent_record"] to navigate from list entry to its parent record
+    // Second path element is [parentObjectType, parentAttributeSlug] to navigate to specific attribute
+    const path = [
+        [listSlug, 'parent_record'],
+        [parentObjectType, parentAttributeSlug],
+    ];
+    // Create constraints object based on condition and value
+    let constraints = {};
+    // Handle different condition types appropriately
+    if (condition === 'equals' || condition === 'eq') {
+        // For exact equality on simple attributes
+        constraints = { value };
+    }
+    else if (condition === 'contains') {
+        // For partial text matching
+        constraints = { contains: value };
+    }
+    else if (condition === 'starts_with') {
+        constraints = { starts_with: value };
+    }
+    else if (condition === 'ends_with') {
+        constraints = { ends_with: value };
+    }
+    else if (condition === 'greater_than' || condition === 'gt') {
+        constraints = { gt: value };
+    }
+    else if (condition === 'less_than' || condition === 'lt') {
+        constraints = { lt: value };
+    }
+    else if (condition === 'greater_than_or_equals' || condition === 'gte') {
+        constraints = { gte: value };
+    }
+    else if (condition === 'less_than_or_equals' || condition === 'lte') {
+        constraints = { lte: value };
+    }
+    else if (condition === 'not_equals' || condition === 'ne') {
+        constraints = { ne: value };
+    }
+    else if (condition === 'is_empty' || condition === 'is_not_set') {
+        constraints = { is_empty: true };
+    }
+    else if (condition === 'is_not_empty' || condition === 'is_set') {
+        constraints = { is_not_empty: true };
+    }
+    else if (condition === 'in') {
+        constraints = { in: Array.isArray(value) ? value : [value] };
+    }
+    else {
+        // Default to exact match if condition is unknown
+        constraints = { value };
+    }
+    // Special case for filtering by record ID
+    if (parentAttributeSlug === 'id' || parentAttributeSlug === 'record_id') {
+        return {
+            path: [[listSlug, 'parent_record']],
+            constraints: { record_id: value },
+        };
+    }
+    // For filtering by name, we need to use full_name property
+    if (parentAttributeSlug === 'name') {
+        if (condition === 'equals') {
+            constraints = { full_name: value };
+        }
+        else if (condition === 'contains') {
+            constraints = { full_name: { contains: value } };
+        }
+        else if (condition === 'starts_with') {
+            constraints = { full_name: { starts_with: value } };
+        }
+        else if (condition === 'ends_with') {
+            constraints = { full_name: { ends_with: value } };
+        }
+    }
+    // For email addresses, we need to use email_address property
+    if (parentAttributeSlug === 'email_addresses') {
+        if (condition === 'equals') {
+            constraints = { email_address: value };
+        }
+        else if (condition === 'contains') {
+            constraints = { email_address: { contains: value } };
+        }
+        else if (condition === 'starts_with') {
+            constraints = { email_address: { starts_with: value } };
+        }
+        else if (condition === 'ends_with') {
+            constraints = { email_address: { ends_with: value } };
+        }
+    }
+    return { path, constraints };
+}
+//# sourceMappingURL=record-utils.js.map

package/dist/utils/record-utils.js.map

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

package/dist/utils/relationship-utils.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Relationship utility functions for working with related records in Attio
+ * Provides functions for creating filters based on relationships between records.
+ */
+import { ListEntryFilters } from '../api/operations/index.js';
+import { ResourceType, RelationshipType } from '../types/attio.js';
+export { RelationshipType };
+/**
+ * Configuration for a relationship-based filter
+ */
+export interface RelationshipFilterConfig {
+    sourceType: ResourceType;
+    targetType: ResourceType;
+    relationshipType: RelationshipType;
+    targetFilters: ListEntryFilters;
+}
+/**
+ * Creates a filter for people based on their associated company attributes
+ *
+ * @param companyFilter - Filters to apply to the related companies
+ * @returns Filter for finding people based on company attributes
+ */
+export declare function createPeopleByCompanyFilter(companyFilter: ListEntryFilters): ListEntryFilters;
+/**
+ * Creates a filter for companies based on their associated people attributes
+ *
+ * @param peopleFilter - Filters to apply to the related people
+ * @returns Filter for finding companies based on people attributes
+ */
+export declare function createCompaniesByPeopleFilter(peopleFilter: ListEntryFilters): ListEntryFilters;
+/**
+ * Creates a filter for records that belong to a specific list
+ *
+ * @param resourceType - The type of records to filter (people or companies)
+ * @param listId - The ID of the list to filter by
+ * @returns Filter for finding records that belong to the list
+ */
+export declare function createRecordsByListFilter(resourceType: ResourceType, listId: string): ListEntryFilters;
+/**
+ * Creates a filter for finding people who work at companies in a specific list
+ *
+ * @param listId - The ID of the list that contains companies
+ * @returns Filter for finding people who work at companies in the specified list
+ */
+export declare function createPeopleByCompanyListFilter(listId: string): ListEntryFilters;
+/**
+ * Creates a filter for finding companies that have people in a specific list
+ *
+ * @param listId - The ID of the list that contains people
+ * @returns Filter for finding companies that have people in the specified list
+ */
+export declare function createCompaniesByPeopleListFilter(listId: string): ListEntryFilters;
+/**
+ * Creates a filter for records that have associated notes matching criteria
+ *
+ * @param resourceType - The type of records to filter (people or companies)
+ * @param textSearch - Text to search for in the notes
+ * @returns Filter for finding records with matching notes
+ */
+export declare function createRecordsByNotesFilter(resourceType: ResourceType, textSearch: string): ListEntryFilters;
+//# sourceMappingURL=relationship-utils.d.ts.map

package/dist/utils/relationship-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationship-utils.d.ts","sourceRoot":"","sources":["../../src/utils/relationship-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAmB,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EACL,YAAY,EAEZ,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAS5B;;GAEG;AACH,MAAM,WAAW,wBAAwB;IAEvC,UAAU,EAAE,YAAY,CAAC;IAGzB,UAAU,EAAE,YAAY,CAAC;IAGzB,gBAAgB,EAAE,gBAAgB,CAAC;IAGnC,aAAa,EAAE,gBAAgB,CAAC;CACjC;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,aAAa,EAAE,gBAAgB,GAC9B,gBAAgB,CAsClB;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,YAAY,EAAE,gBAAgB,GAC7B,gBAAgB,CAsClB;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,MAAM,GACb,gBAAgB,CAoClB;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,MAAM,GACb,gBAAgB,CAuBlB;AAED;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,MAAM,GACb,gBAAgB,CAuBlB;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,MAAM,GACjB,gBAAgB,CA+BlB"}