attio-mcp 1.1.10 → 1.2.0

package/dist/utils/client-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client-resolver.d.ts","sourceRoot":"","sources":["../../src/utils/client-resolver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAwCtC;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,aAAa,CAuFlD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,aAAa,CAOtE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,aAAa,CAIvD"}
+{"version":3,"file":"client-resolver.d.ts","sourceRoot":"","sources":["../../src/utils/client-resolver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAqEtC;;;;;;GAMG;AACH,wBAAgB,kBAAkB,IAAI,aAAa,CAyFlD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,aAAa,CAOtE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,aAAa,CAIvD"}

package/dist/utils/client-resolver.js

@@ -17,20 +17,42 @@ function assertAxiosInstance(value, source) {
         'defaults' in candidate &&
         typeof candidate.defaults === 'object';
     if (!hasGetMethod || !hasDefaults) {
-        throw new Error(`${source} returned invalid Axios client instance`);
+        // Enhanced diagnostic information
+        const diagnostics = {
+            valueType: typeof value,
+            isNull: value === null,
+            isUndefined: value === undefined,
+            isObject: typeof value === 'object' && value !== null,
+            hasGetMethod,
+            hasDefaults,
+            hasDefaultsProperty: candidate && typeof candidate === 'object' && 'defaults' in candidate,
+            defaultsType: candidate && typeof candidate === 'object' && 'defaults' in candidate
+                ? typeof candidate.defaults
+                : 'N/A',
+            availableProperties: candidate && typeof candidate === 'object'
+                ? Object.keys(candidate).slice(0, 10)
+                : [],
+        };
+        if (process.env.MCP_LOG_LEVEL === 'DEBUG') {
+            console.error(`[client-resolver:assertAxiosInstance] Validation failed for ${source}:`, diagnostics);
+        }
+        throw new Error(`${source} returned invalid Axios client instance (hasGetMethod=${hasGetMethod}, hasDefaults=${hasDefaults})`);
     }
 }
 /**
  * Resolves an Attio client instance using the unified interface.
- * Prioritises createAttioClient(config) → createAttioClient(apiKey) → getAttioClient() → buildAttioClient().
+ * Uses getAttioClient() which handles caching, environment detection, and strategy pattern.
+ *
+ * This simplification fixes Issue #904 client initialization validation failures by using
+ * the proven getAttioClient() code path instead of attempting multiple factory methods.
  */
 export function resolveAttioClient() {
     const mod = AttioClientModule;
-    const contextApiKey = getContextApiKey();
-    const envApiKey = process.env.ATTIO_API_KEY;
-    const resolvedApiKey = envApiKey || contextApiKey;
-    // Debug logging for Issue #891: Track API key resolution
+    // Debug logging for API key resolution (informational only)
     if (process.env.MCP_LOG_LEVEL === 'DEBUG') {
+        const contextApiKey = getContextApiKey();
+        const envApiKey = process.env.ATTIO_API_KEY;
+        const resolvedApiKey = envApiKey || contextApiKey;
         console.error('[client-resolver:resolve] API key resolution:', {
             hasEnvApiKey: Boolean(envApiKey),
             envKeyLength: envApiKey?.length || 0,
@@ -46,47 +68,49 @@ export function resolveAttioClient() {
             timestamp: new Date().toISOString(),
         });
     }
-    // Try unified createAttioClient with config (new interface)
+    // Use getAttioClient() - it handles all the complexity:
+    // - Caching (ClientCache and legacy apiInstance)
+    // - Environment detection (E2E, test, production modes)
+    // - Strategy pattern (ProductionClientStrategy, E2EClientStrategy, etc.)
+    // - API key resolution (env, context, config)
+    // This is the proven code path used throughout the codebase
+    if (typeof mod.getAttioClient === 'function') {
+        if (process.env.MCP_LOG_LEVEL === 'DEBUG') {
+            console.error('[client-resolver:resolve] Using getAttioClient()');
+        }
+        const client = mod.getAttioClient();
+        assertAxiosInstance(client, 'getAttioClient()');
+        return client;
+    }
+    // Fallback to createAttioClient with config object
     if (typeof mod.createAttioClient === 'function') {
+        if (process.env.MCP_LOG_LEVEL === 'DEBUG') {
+            console.error('[client-resolver:resolve] Fallback to createAttioClient(config)');
+        }
         try {
-            // If we have an API key, prefer the legacy string signature for backward compatibility
-            if (resolvedApiKey) {
-                if (process.env.MCP_LOG_LEVEL === 'DEBUG') {
-                    console.error('[client-resolver:resolve] Creating client with API key');
-                }
-                const client = mod.createAttioClient(resolvedApiKey);
-                assertAxiosInstance(client, 'createAttioClient(apiKey)');
-                return client;
-            }
-            else {
-                if (process.env.MCP_LOG_LEVEL === 'DEBUG') {
-                    console.error('[client-resolver:resolve] Creating client without API key (will fail on first request)');
-                }
-                // Use config object (new unified interface)
-                const config = {};
-                const client = mod.createAttioClient(config);
-                assertAxiosInstance(client, 'createAttioClient(config)');
-                return client;
-            }
+            const config = {};
+            const client = mod.createAttioClient(config);
+            assertAxiosInstance(client, 'createAttioClient(config)');
+            return client;
         }
         catch (error) {
             if (process.env.MCP_LOG_LEVEL === 'DEBUG') {
                 console.error('[client-resolver:resolve] createAttioClient failed:', error);
             }
-            // Continue to fallback methods
+            // Continue to last resort
         }
     }
-    // Fallback to getAttioClient if createAttioClient fails
-    if (typeof mod.getAttioClient === 'function') {
-        const client = mod.getAttioClient();
-        assertAxiosInstance(client, 'getAttioClient()');
-        return client;
-    }
     // Last resort: buildAttioClient
     if (typeof mod.buildAttioClient === 'function') {
+        const contextApiKey = getContextApiKey();
+        const envApiKey = process.env.ATTIO_API_KEY;
+        const resolvedApiKey = envApiKey || contextApiKey;
         if (!resolvedApiKey) {
             throw new Error('Attio API key is required for client initialization. Please set ATTIO_API_KEY environment variable.');
         }
+        if (process.env.MCP_LOG_LEVEL === 'DEBUG') {
+            console.error('[client-resolver:resolve] Last resort: buildAttioClient');
+        }
         const client = mod.buildAttioClient({ apiKey: resolvedApiKey });
         assertAxiosInstance(client, 'buildAttioClient()');
         return client;

package/dist/utils/client-resolver.js.map

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

package/dist/utils/filters/reference-attribute-helper.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Reference Attribute Helper
+ *
+ * Utilities for detecting and handling reference attributes in filter transformations.
+ * Reference attributes (owner, assignee, company, person) require nested field specification
+ * in Attio API filter syntax.
+ */
+import { getAttributeTypeInfo } from '../../api/attribute-types.js';
+export { getAttributeTypeInfo };
+/**
+ * UUID v4 pattern for detecting UUID values
+ * Exported for use in filter translators (PR #904 Phase 2)
+ */
+export declare const UUID_PATTERN: RegExp;
+/**
+ * Email pattern for workspace member validation
+ *
+ * Uses permissive pattern to handle edge cases:
+ * - Test environments may use simplified emails (e.g., test@local.dev)
+ * - Some valid domains have short TLDs or special characters
+ * - Attio API performs canonical validation, so false positives fail fast
+ *
+ * Pattern validates: non-whitespace + @ + non-whitespace + . + non-whitespace
+ * Accepts: user@example.com, test@local.dev, admin@co.uk
+ * Rejects: missing @, missing domain, whitespace, no TLD
+ * Exported for use in filter translators (PR #904 Phase 2)
+ */
+export declare const EMAIL_PATTERN: RegExp;
+/**
+ * Known actor-reference slugs that require special handling in list entry context
+ * When resourceType is unavailable, these slugs with UUID values must use referenced_actor_id
+ * (not record_id) to generate correct actor-reference filter structure
+ * Exported for use in filter translators (PR #904 Phase 2)
+ */
+export declare const KNOWN_ACTOR_REFERENCE_SLUGS: Set<string>;
+/**
+ * Per-request cache for attribute type info to avoid repeated lookups
+ * Key format: `${resourceType}:${attributeSlug}`
+ */
+export type AttributeTypeCache = Map<string, Awaited<ReturnType<typeof getAttributeTypeInfo>>>;
+/**
+ * Check if an attribute is a reference type that requires nested field specification
+ *
+ * @param resourceType - The resource type (e.g., 'deals', 'companies'), or undefined for slug-based fallback
+ * @param attributeSlug - The attribute slug (e.g., 'owner', 'assignee')
+ * @param cache - Optional per-request cache to avoid repeated getAttributeTypeInfo calls
+ * @returns True if the attribute is a reference type
+ */
+export declare function isReferenceAttribute(resourceType: string | undefined, attributeSlug: string, cache?: AttributeTypeCache): Promise<boolean>;
+/**
+ * Determine which field to use for a reference attribute based on the value and type
+ *
+ * @param value - The filter value (can be UUID, name, or array of UUIDs/names for in/not_in operators)
+ * @param attioType - The Attio attribute type (optional)
+ * @returns The field name to use ('record_id', 'name', or 'referenced_actor_id' for actor-reference)
+ */
+export declare function determineReferenceField(value: unknown, attioType?: string): string;
+/**
+ * Get the appropriate reference field for an attribute, considering type-specific mappings
+ *
+ * @param resourceType - The resource type, or undefined for slug-based fallback
+ * @param attributeSlug - The attribute slug
+ * @param value - The filter value
+ * @param cache - Optional per-request cache to avoid repeated getAttributeTypeInfo calls
+ * @returns The field name to use for filtering
+ * @throws FilterValidationError if email validation fails for workspace-member fields
+ */
+export declare function getReferenceFieldForAttribute(resourceType: string | undefined, attributeSlug: string, value: unknown, cache?: AttributeTypeCache): Promise<string>;
+//# sourceMappingURL=reference-attribute-helper.d.ts.map

package/dist/utils/filters/reference-attribute-helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-attribute-helper.d.ts","sourceRoot":"","sources":["../../../src/utils/filters/reference-attribute-helper.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAQhE,OAAO,EAAE,oBAAoB,EAAE,CAAC;AAuBhC;;;GAGG;AACH,eAAO,MAAM,YAAY,QACiD,CAAC;AAE3E;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,aAAa,QAA+B,CAAC;AAwB1D;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,aAKtC,CAAC;AAEH;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,GAAG,CAClC,MAAM,EACN,OAAO,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,CACjD,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,aAAa,EAAE,MAAM,EACrB,KAAK,CAAC,EAAE,kBAAkB,GACzB,OAAO,CAAC,OAAO,CAAC,CA+BlB;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,EACd,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CAuCR;AAED;;;;;;;;;GASG;AACH,wBAAsB,6BAA6B,CACjD,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,OAAO,EACd,KAAK,CAAC,EAAE,kBAAkB,GACzB,OAAO,CAAC,MAAM,CAAC,CA2HjB"}

package/dist/utils/filters/reference-attribute-helper.js

@@ -0,0 +1,262 @@
+/**
+ * Reference Attribute Helper
+ *
+ * Utilities for detecting and handling reference attributes in filter transformations.
+ * Reference attributes (owner, assignee, company, person) require nested field specification
+ * in Attio API filter syntax.
+ */
+import { getAttributeTypeInfo } from '../../api/attribute-types.js';
+import { FilterValidationError, FilterErrorCategory, } from '../../errors/api-errors.js';
+import { warn } from '../../utils/logger.js';
+// Re-export getAttributeTypeInfo for use in translators
+export { getAttributeTypeInfo };
+/**
+ * Attio attribute types that require reference field nesting
+ */
+const REFERENCE_TYPES = [
+    'record-reference',
+    'actor-reference',
+    'workspace-member',
+];
+/**
+ * Field to use for specific attribute types that require fixed field names
+ * Only include types that ALWAYS use the same field regardless of value
+ *
+ * NOTE: actor-reference fields (like deals.owner) can accept either email OR UUID
+ * depending on the value format, so we use heuristic detection instead of forcing email.
+ * Only workspace-member typed fields must use email.
+ */
+const REFERENCE_FIELD_MAPPING = {
+    'workspace-member': 'email', // workspace members always filter by email
+};
+/**
+ * UUID v4 pattern for detecting UUID values
+ * Exported for use in filter translators (PR #904 Phase 2)
+ */
+export const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+/**
+ * Email pattern for workspace member validation
+ *
+ * Uses permissive pattern to handle edge cases:
+ * - Test environments may use simplified emails (e.g., test@local.dev)
+ * - Some valid domains have short TLDs or special characters
+ * - Attio API performs canonical validation, so false positives fail fast
+ *
+ * Pattern validates: non-whitespace + @ + non-whitespace + . + non-whitespace
+ * Accepts: user@example.com, test@local.dev, admin@co.uk
+ * Rejects: missing @, missing domain, whitespace, no TLD
+ * Exported for use in filter translators (PR #904 Phase 2)
+ */
+export const EMAIL_PATTERN = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+/**
+ * Known reference attribute slugs that commonly require nested field specification
+ * Used as fallback when resourceType is unavailable (e.g., list entries)
+ */
+const KNOWN_REFERENCE_SLUGS = new Set([
+    'owner',
+    'assignee',
+    'assignee_id', // workspace-member type that requires email field
+    'company',
+    'person',
+    'primary_contact',
+    'workspace_member',
+    'created_by',
+    'modified_by',
+]);
+/**
+ * Slugs that ALWAYS require email field (workspace-member type)
+ * Note: actor-reference slugs like 'owner', 'assignee' use flexible detection (UUID vs email vs name)
+ */
+const WORKSPACE_MEMBER_SLUGS = new Set(['workspace_member', 'assignee_id']);
+/**
+ * Known actor-reference slugs that require special handling in list entry context
+ * When resourceType is unavailable, these slugs with UUID values must use referenced_actor_id
+ * (not record_id) to generate correct actor-reference filter structure
+ * Exported for use in filter translators (PR #904 Phase 2)
+ */
+export const KNOWN_ACTOR_REFERENCE_SLUGS = new Set([
+    'owner',
+    'assignee',
+    'created_by',
+    'modified_by',
+]);
+/**
+ * Check if an attribute is a reference type that requires nested field specification
+ *
+ * @param resourceType - The resource type (e.g., 'deals', 'companies'), or undefined for slug-based fallback
+ * @param attributeSlug - The attribute slug (e.g., 'owner', 'assignee')
+ * @param cache - Optional per-request cache to avoid repeated getAttributeTypeInfo calls
+ * @returns True if the attribute is a reference type
+ */
+export async function isReferenceAttribute(resourceType, attributeSlug, cache) {
+    // If resourceType is unavailable (e.g., list entries), use slug-based fallback
+    if (!resourceType) {
+        return KNOWN_REFERENCE_SLUGS.has(attributeSlug);
+    }
+    try {
+        // Check cache first
+        const cacheKey = `${resourceType}:${attributeSlug}`;
+        let typeInfo = cache?.get(cacheKey);
+        if (!typeInfo) {
+            typeInfo = await getAttributeTypeInfo(resourceType, attributeSlug);
+            cache?.set(cacheKey, typeInfo);
+        }
+        return REFERENCE_TYPES.includes(typeInfo.attioType);
+    }
+    catch (error) {
+        // If metadata lookup fails, fall back to slug-based detection
+        warn('filters/reference-attribute-helper', `Metadata lookup failed for ${resourceType}.${attributeSlug}, using slug-based fallback`, {
+            resourceType,
+            attributeSlug,
+            reason: 'metadata_lookup_failed',
+            error: error instanceof Error ? error.message : String(error),
+        });
+        return KNOWN_REFERENCE_SLUGS.has(attributeSlug);
+    }
+}
+/**
+ * Determine which field to use for a reference attribute based on the value and type
+ *
+ * @param value - The filter value (can be UUID, name, or array of UUIDs/names for in/not_in operators)
+ * @param attioType - The Attio attribute type (optional)
+ * @returns The field name to use ('record_id', 'name', or 'referenced_actor_id' for actor-reference)
+ */
+export function determineReferenceField(value, attioType) {
+    // Actor-reference attributes use referenced_actor_id (always UUID)
+    if (attioType === 'actor-reference') {
+        return 'referenced_actor_id';
+    }
+    // Handle array values (for in/not_in operators)
+    if (Array.isArray(value)) {
+        // Empty arrays default to name field
+        if (value.length === 0) {
+            return 'name';
+        }
+        // Check if all elements are UUID strings
+        const allUUIDs = value.every((v) => typeof v === 'string' && UUID_PATTERN.test(v));
+        const allNonUUIDs = value.every((v) => typeof v === 'string' && !UUID_PATTERN.test(v));
+        // Reject mixed-type arrays (some UUIDs, some names)
+        if (!allUUIDs && !allNonUUIDs) {
+            throw new FilterValidationError(`Mixed UUID and non-UUID values not supported in array filters. ` +
+                `Received array with both types. Use separate filters or ensure all values are the same type.`, FilterErrorCategory.VALUE);
+        }
+        return allUUIDs ? 'record_id' : 'name';
+    }
+    // Handle single values
+    if (typeof value === 'string' && UUID_PATTERN.test(value)) {
+        return 'record_id';
+    }
+    // Otherwise use name field
+    return 'name';
+}
+/**
+ * Get the appropriate reference field for an attribute, considering type-specific mappings
+ *
+ * @param resourceType - The resource type, or undefined for slug-based fallback
+ * @param attributeSlug - The attribute slug
+ * @param value - The filter value
+ * @param cache - Optional per-request cache to avoid repeated getAttributeTypeInfo calls
+ * @returns The field name to use for filtering
+ * @throws FilterValidationError if email validation fails for workspace-member fields
+ */
+export async function getReferenceFieldForAttribute(resourceType, attributeSlug, value, cache) {
+    // Special case: workspace_member and assignee_id slugs ALWAYS use email
+    // regardless of metadata availability
+    if (attributeSlug === 'workspace_member' || attributeSlug === 'assignee_id') {
+        // Validate email format
+        if (typeof value !== 'string' || !EMAIL_PATTERN.test(value)) {
+            throw new FilterValidationError(`Invalid email format for ${attributeSlug}: "${value}". Expected valid email address.`, FilterErrorCategory.VALUE);
+        }
+        return 'email';
+    }
+    // If resourceType is available, use metadata to determine field
+    if (resourceType) {
+        try {
+            // Check cache first
+            const cacheKey = `${resourceType}:${attributeSlug}`;
+            let typeInfo = cache?.get(cacheKey);
+            if (!typeInfo) {
+                typeInfo = await getAttributeTypeInfo(resourceType, attributeSlug);
+                cache?.set(cacheKey, typeInfo);
+            }
+            // Check for attribute-specific mapping (only workspace-member type requires fixed email)
+            if (REFERENCE_FIELD_MAPPING[typeInfo.attioType]) {
+                const field = REFERENCE_FIELD_MAPPING[typeInfo.attioType];
+                // Validate email if this is an email field
+                if (field === 'email') {
+                    if (typeof value !== 'string' || !EMAIL_PATTERN.test(value)) {
+                        throw new FilterValidationError(`Invalid email format for ${attributeSlug}: "${value}". Expected valid email address.`, FilterErrorCategory.VALUE);
+                    }
+                }
+                return field;
+            }
+            // Actor-reference fields (e.g., owner, assignee) support flexible filtering:
+            // - Email address → filter by email field
+            // - UUID (workspace member ID) → filter by referenced_actor_id (requires referenced_actor_type)
+            // - Name (plain text) → filter by name field
+            if (typeInfo.attioType === 'actor-reference') {
+                if (typeof value !== 'string') {
+                    throw new FilterValidationError(`Actor-reference attribute "${attributeSlug}" requires a string value (email, name, or UUID). Got: ${typeof value}`, FilterErrorCategory.VALUE);
+                }
+                // Detect value type and return appropriate field
+                if (EMAIL_PATTERN.test(value)) {
+                    return 'email';
+                }
+                else if (UUID_PATTERN.test(value)) {
+                    return 'referenced_actor_id';
+                }
+                else {
+                    // Plain text name
+                    return 'name';
+                }
+            }
+            // Fall back to UUID vs name detection for record-reference types
+            return determineReferenceField(value, typeInfo.attioType);
+        }
+        catch (error) {
+            // Re-throw FilterValidationError
+            if (error instanceof FilterValidationError) {
+                throw error;
+            }
+            // Fall through to slug-based detection if metadata lookup fails
+            warn('filters/reference-attribute-helper', `Metadata lookup failed in getReferenceFieldForAttribute for ${resourceType}.${attributeSlug}, using slug-based fallback`, {
+                resourceType,
+                attributeSlug,
+                reason: 'metadata_lookup_failed',
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    // ResourceType unavailable or metadata lookup failed - use slug-based detection
+    // Check if this is a known workspace member slug (requires email field)
+    if (WORKSPACE_MEMBER_SLUGS.has(attributeSlug)) {
+        // Validate email format
+        if (typeof value !== 'string' || !EMAIL_PATTERN.test(value)) {
+            throw new FilterValidationError(`Invalid email format for ${attributeSlug}: "${value}". Expected valid email address. Workspace member attributes (owner, assignee, etc.) require email addresses.`, FilterErrorCategory.VALUE);
+        }
+        return 'email';
+    }
+    // Special handling for known actor-reference slugs (owner, assignee, created_by, modified_by)
+    // When resourceType unavailable (e.g., list entries), we can't query metadata but can use slug patterns
+    if (KNOWN_ACTOR_REFERENCE_SLUGS.has(attributeSlug)) {
+        // Actor-reference attributes support email, UUID, or name filtering
+        if (typeof value !== 'string') {
+            throw new FilterValidationError(`Actor-reference attribute "${attributeSlug}" requires a string value (email, name, or UUID). Got: ${typeof value}`, FilterErrorCategory.VALUE);
+        }
+        // Detect value type and return appropriate field
+        if (EMAIL_PATTERN.test(value)) {
+            return 'email';
+        }
+        else if (UUID_PATTERN.test(value)) {
+            // UUID values must use referenced_actor_id for actor-reference structure
+            return 'referenced_actor_id';
+        }
+        else {
+            // Plain text name
+            return 'name';
+        }
+    }
+    // For other reference slugs (company, person, etc.), use basic heuristic detection (UUID vs name)
+    return determineReferenceField(value);
+}
+//# sourceMappingURL=reference-attribute-helper.js.map

package/dist/utils/filters/reference-attribute-helper.js.map

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

package/dist/utils/filters/translators.d.ts

@@ -12,73 +12,9 @@
  * - Reverse transformation (API to MCP)
  */
 import { ListEntryFilters, ListEntryFilter, AttioApiFilter, AttioQueryApiFilter, FilterConditionType } from './types.js';
-/**
- * Transforms list entry filters to the format expected by the Attio API
- *
- * This is the main transformation function that converts MCP filter specifications
- * into the format expected by the Attio API. It handles both AND and OR logical
- * operators and provides comprehensive validation.
- *
- * **Key Features:**
- * - Validates filter structure using centralized validation utilities
- * - Supports both AND logic (default) and OR logic (matchAny: true)
- * - Handles empty filter arrays gracefully (returns empty object)
- * - Preserves filter condition types and values
- * - Provides detailed error messages with examples on validation failure
- *
- * @param filters - Filter configuration from the MCP API (may have optional filters array)
- * @param validateConditions - Whether to validate condition types against known Attio API operators
- * @returns Transformed filter object for Attio API, or empty object if no valid filters
- * @throws FilterValidationError if validation fails with consistent error messages and examples
- *
- * @example
- * // Simple filter with a single condition
- * const simpleFilter = {
- *   filters: [
- *     {
- *       attribute: { slug: 'name' },
- *       condition: 'contains',
- *       value: 'Company Inc'
- *     }
- *   ]
- * };
- *
- * // Filter with OR logic between conditions
- * const orFilter = {
- *   filters: [
- *     {
- *       attribute: { slug: 'name' },
- *       condition: 'contains',
- *       value: 'Inc'
- *     },
- *     {
- *       attribute: { slug: 'industry' },
- *       condition: 'equals',
- *       value: 'Technology'
- *     }
- *   ],
- *   matchAny: true  // Use OR logic
- * };
- *
- * // Filter with multiple conditions (AND logic by default)
- * const multipleFilter = {
- *   filters: [
- *     {
- *       attribute: { slug: 'name' },
- *       condition: 'contains',
- *       value: 'Inc'
- *     },
- *     {
- *       attribute: { slug: 'website' },
- *       condition: 'contains',
- *       value: '.com'
- *     }
- *   ]
- * };
- */
-export declare function transformFiltersToApiFormat(filters: ListEntryFilters | undefined, validateConditions?: boolean, isListEntryContext?: boolean): {
+export declare function transformFiltersToApiFormat(filters: ListEntryFilters | undefined, validateConditions?: boolean, isListEntryContext?: boolean, resourceType?: string): Promise<{
     filter?: AttioApiFilter;
-};
+}>;
 /**
  * Transforms list entry filters to the new Query API format with path and constraints
  *
@@ -95,7 +31,7 @@ export declare function transformFiltersToQueryApiFormat(filters: ListEntryFilte
  * Converts a single filter operator to API format
  *
  * @param operator - The operator to convert (e.g., 'equals', 'contains')
- * @returns The operator in API format (e.g., '$equals', '$contains')
+ * @returns The operator in API format (e.g., '$eq', '$contains')
  */
 export declare function convertOperatorToApiFormat(operator: string): string;
 /**

package/dist/utils/filters/translators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"translators.d.ts","sourceRoot":"","sources":["../../../src/utils/filters/translators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAUH,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EAEpB,MAAM,YAAY,CAAC;AAapB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,gBAAgB,GAAG,SAAS,EACrC,kBAAkB,GAAE,OAAc,EAClC,kBAAkB,GAAE,OAAe,GAClC;IAAE,MAAM,CAAC,EAAE,cAAc,CAAA;CAAE,CAsE7B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,gBAAgB,GAAG,SAAS,EACrC,kBAAkB,GAAE,OAAc,GACjC,mBAAmB,CAqGrB;AA+OD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGnE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAOpE;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,mBAAmB,GAC7B,OAAO,CAaT;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,eAAe,GACtB,cAAc,CAoBhB;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,cAAc,GACxB,gBAAgB,CA6ClB"}
+{"version":3,"file":"translators.d.ts","sourceRoot":"","sources":["../../../src/utils/filters/translators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAUH,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EAEpB,MAAM,YAAY,CAAC;AAkIpB,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,gBAAgB,GAAG,SAAS,EACrC,kBAAkB,GAAE,OAAc,EAClC,kBAAkB,GAAE,OAAe,EACnC,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC;IAAE,MAAM,CAAC,EAAE,cAAc,CAAA;CAAE,CAAC,CAkGtC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,gBAAgB,GAAG,SAAS,EACrC,kBAAkB,GAAE,OAAc,GACjC,mBAAmB,CAqGrB;AAgbD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGnE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAOpE;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,mBAAmB,GAC7B,OAAO,CAaT;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,eAAe,GACtB,cAAc,CAoBhB;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,cAAc,GACxB,gBAAgB,CA6ClB"}