@iflow-mcp/attio-mcp 1.3.6

package/dist/handlers/tool-configs/universal/core/pii-sanitizer.js

@@ -0,0 +1,235 @@
+/**
+ * PII Sanitization for Validation Metadata
+ *
+ * Ensures that validation messages and metadata do not expose
+ * personally identifiable information (PII) in logs or user-facing messages.
+ */
+import { createScopedLogger } from '../../../../utils/logger.js';
+import { extractDisplayValue } from './value-extractors.js';
+/**
+ * Check if debug logging is enabled in current environment
+ */
+const isDebugEnabled = () => {
+    if (process.env.NODE_ENV === 'production')
+        return false;
+    if (process.env.DEBUG_DISABLE === 'true')
+        return false;
+    return (process.env.DEBUG_MODE === 'true' || process.env.NODE_ENV === 'development');
+};
+const logger = createScopedLogger('pii-sanitizer');
+/**
+ * PII patterns to detect and sanitize
+ */
+const PII_PATTERNS = {
+    // Email addresses
+    email: {
+        pattern: /\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Z|a-z]{2,}\b/g,
+        replacement: '[EMAIL]',
+    },
+    // Phone numbers (various formats)
+    phone: {
+        pattern: /(?:\+?1[-.\s]?)?(?:\(?[0-9]{3}\)?[-.\s]?)?[0-9]{3}[-.\s]?[0-9]{4}/g,
+        replacement: '[PHONE]',
+    },
+    // Social Security Numbers
+    ssn: {
+        pattern: /\b\d{3}-?\d{2}-?\d{4}\b/g,
+        replacement: '[SSN]',
+    },
+    // Credit Card Numbers (basic pattern)
+    creditCard: {
+        pattern: /\b\d{4}[-\s]?\d{4}[-\s]?\d{4}[-\s]?\d{4}\b/g,
+        replacement: '[CARD]',
+    },
+    // IP Addresses
+    ipAddress: {
+        pattern: /\b(?:[0-9]{1,3}\.){3}[0-9]{1,3}\b/g,
+        replacement: '[IP]',
+    },
+    // Generic sensitive number patterns (long sequences)
+    sensitiveNumbers: {
+        pattern: /\b\d{9,}\b/g,
+        replacement: '[NUMBER]',
+    },
+};
+/**
+ * Fields that commonly contain PII and should be sanitized
+ */
+const PII_FIELD_NAMES = new Set([
+    'email',
+    'email_address',
+    'personal_email',
+    'work_email',
+    'phone',
+    'phone_number',
+    'mobile',
+    'mobile_phone',
+    'personal_phone',
+    'work_phone',
+    'ssn',
+    'social_security_number',
+    'tax_id',
+    'credit_card',
+    'credit_card_number',
+    'card_number',
+    'address',
+    'home_address',
+    'billing_address',
+    'street_address',
+    'first_name',
+    'last_name',
+    'full_name',
+    'date_of_birth',
+    'dob',
+    'birth_date',
+    'passport',
+    'passport_number',
+    'driver_license',
+    'drivers_license_number',
+]);
+/**
+ * Check if a field name indicates it might contain PII
+ */
+export const isPotentialPIIField = (fieldName) => {
+    const normalizedFieldName = fieldName.toLowerCase().replace(/[-_\s]/g, '');
+    // Check exact matches
+    if (PII_FIELD_NAMES.has(fieldName.toLowerCase())) {
+        return true;
+    }
+    // Check for partial matches
+    const piiKeywords = [
+        'email',
+        'phone',
+        'ssn',
+        'address',
+        'name',
+        'birth',
+        'card',
+    ];
+    return piiKeywords.some((keyword) => normalizedFieldName.includes(keyword));
+};
+/**
+ * Sanitize a string value for PII
+ */
+export const sanitizeStringValue = (value) => {
+    if (typeof value !== 'string' || !value)
+        return value;
+    let sanitized = value;
+    // Apply all PII patterns
+    for (const [patternName, config] of Object.entries(PII_PATTERNS)) {
+        const before = sanitized;
+        sanitized = sanitized.replace(config.pattern, config.replacement);
+        if (before !== sanitized && isDebugEnabled()) {
+            logger.debug('PII pattern detected and sanitized', {
+                pattern: patternName,
+                originalLength: before.length,
+                sanitizedLength: sanitized.length,
+            });
+        }
+    }
+    return sanitized;
+};
+/**
+ * Sanitize any value (string, object, array) for PII
+ */
+export const sanitizeValue = (value) => {
+    if (value === null || value === undefined) {
+        return value;
+    }
+    if (typeof value === 'string') {
+        return sanitizeStringValue(value);
+    }
+    if (typeof value === 'number' || typeof value === 'boolean') {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        return value.map(sanitizeValue);
+    }
+    if (typeof value === 'object') {
+        const sanitizedObject = {};
+        for (const [key, val] of Object.entries(value)) {
+            // Check if the field name suggests it contains PII
+            if (isPotentialPIIField(key)) {
+                if (typeof val === 'string') {
+                    sanitizedObject[key] = '[REDACTED]';
+                    if (isDebugEnabled()) {
+                        logger.debug('PII field redacted', { fieldName: key });
+                    }
+                }
+                else {
+                    sanitizedObject[key] = sanitizeValue(val);
+                }
+            }
+            else {
+                sanitizedObject[key] = sanitizeValue(val);
+            }
+        }
+        return sanitizedObject;
+    }
+    return value;
+};
+export const sanitizeValidationMetadata = (metadata) => {
+    if (!metadata)
+        return undefined;
+    const sanitized = {};
+    // Sanitize warnings
+    if (metadata.warnings?.length) {
+        sanitized.warnings = metadata.warnings.map((warning) => sanitizeStringValue(warning));
+    }
+    // Sanitize suggestions
+    if (metadata.suggestions?.length) {
+        sanitized.suggestions = metadata.suggestions.map((suggestion) => sanitizeStringValue(suggestion));
+    }
+    // Sanitize actual values
+    if (metadata.actualValues && Object.keys(metadata.actualValues).length > 0) {
+        const sanitizedValues = {};
+        for (const [key, value] of Object.entries(metadata.actualValues)) {
+            if (isPotentialPIIField(key)) {
+                sanitizedValues[key] = '[REDACTED]';
+                if (isDebugEnabled()) {
+                    logger.info('PII field redacted in validation metadata', {
+                        fieldName: key,
+                        valueType: typeof value,
+                    });
+                }
+            }
+            else {
+                sanitizedValues[key] = sanitizeValue(value);
+            }
+        }
+        sanitized.actualValues = sanitizedValues;
+    }
+    return sanitized;
+};
+/**
+ * Enhanced format function with PII sanitization
+ */
+export const formatSanitizedActualValue = (value) => {
+    const sanitized = sanitizeValue(value);
+    const displayValue = extractDisplayValue(sanitized);
+    if (displayValue) {
+        return sanitizeStringValue(displayValue);
+    }
+    if (typeof sanitized === 'string' && sanitized.trim().length > 0) {
+        return sanitized.trim();
+    }
+    if (Array.isArray(sanitized) ||
+        (sanitized && typeof sanitized === 'object')) {
+        return JSON.stringify(sanitized);
+    }
+    return String(sanitized);
+};
+/**
+ * Safe logging function that sanitizes messages before logging
+ */
+export const sanitizedLog = (logger, level, message, data) => {
+    // Skip debug logging in production unless explicitly enabled
+    if (level === 'debug' && !isDebugEnabled())
+        return;
+    const sanitizedMessage = sanitizeStringValue(message);
+    const sanitizedData = data
+        ? sanitizeValue(data)
+        : undefined;
+    logger[level](sanitizedMessage, sanitizedData);
+};
+//# sourceMappingURL=pii-sanitizer.js.map

package/dist/handlers/tool-configs/universal/core/pii-sanitizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pii-sanitizer.js","sourceRoot":"","sources":["../../../../../src/handlers/tool-configs/universal/core/pii-sanitizer.ts"],"names":[],"mappings":"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"}

package/dist/handlers/tool-configs/universal/core/record-details-operations.d.ts

@@ -0,0 +1,39 @@
+import { UniversalToolConfig, UniversalRecordDetailsParams } from '../types.js';
+import { AttioRecord } from '../../../../types/attio.js';
+export declare const getRecordDetailsConfig: UniversalToolConfig<UniversalRecordDetailsParams, AttioRecord>;
+export declare const getRecordDetailsDefinition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            resource_type: {
+                type: "string";
+                description: string;
+            };
+            record_id: {
+                type: "string";
+                description: string;
+            };
+            fields: {
+                type: "array";
+                items: {
+                    type: "string";
+                };
+                description: string;
+            };
+        };
+        required: ("record_id" | "resource_type")[];
+        additionalProperties: boolean;
+        examples: {
+            resource_type: string;
+            record_id: string;
+            fields: string[];
+        }[];
+    };
+    annotations: {
+        readOnlyHint: boolean;
+        idempotentHint: boolean;
+    };
+};
+//# sourceMappingURL=record-details-operations.d.ts.map

package/dist/handlers/tool-configs/universal/core/record-details-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-details-operations.d.ts","sourceRoot":"","sources":["../../../../../src/handlers/tool-configs/universal/core/record-details-operations.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,4BAA4B,EAE7B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAazD,eAAO,MAAM,sBAAsB,EAAE,mBAAmB,CACtD,4BAA4B,EAC5B,WAAW,CA4JZ,CAAC;AAEF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAetC,CAAC"}

package/dist/handlers/tool-configs/universal/core/record-details-operations.js

@@ -0,0 +1,133 @@
+import { UniversalResourceType, } from '../types.js';
+import { getRecordDetailsSchema, validateUniversalToolParams, } from '../schemas.js';
+import { handleUniversalGetDetails, getSingularResourceType, } from '../shared-handlers.js';
+import { handleSearchError } from './error-utils.js';
+import { UniversalUtilityService } from '../../../../services/UniversalUtilityService.js';
+import { formatToolDescription } from '../../../../handlers/tools/standards/index.js';
+export const getRecordDetailsConfig = {
+    name: 'get_record_details',
+    handler: async (params) => {
+        try {
+            const sanitizedParams = validateUniversalToolParams('get_record_details', params);
+            return await handleUniversalGetDetails(sanitizedParams);
+        }
+        catch (error) {
+            return await handleSearchError(error, params.resource_type, params);
+        }
+    },
+    formatResult: (record, ...args) => {
+        const resourceType = args[0];
+        if (!record) {
+            return 'Record not found';
+        }
+        const resourceTypeName = resourceType
+            ? getSingularResourceType(resourceType)
+            : 'record';
+        const name = UniversalUtilityService.extractDisplayName(record.values || {});
+        const id = String(record.id?.record_id || 'unknown');
+        let details = `${resourceTypeName.charAt(0).toUpperCase() + resourceTypeName.slice(1)}: ${name}\nID: ${id}\n\n`;
+        if (record.values) {
+            let fieldOrder = [
+                'email',
+                'domains',
+                'phone',
+                'description',
+                'categories',
+                'primary_location',
+            ];
+            if (resourceType === UniversalResourceType.PEOPLE) {
+                fieldOrder = [
+                    'email_addresses',
+                    'phone_numbers',
+                    'job_title',
+                    'description',
+                    'primary_location',
+                ];
+                if (record.values.associated_company &&
+                    Array.isArray(record.values.associated_company)) {
+                    const companies = record.values.associated_company
+                        .map((c) => c.target_record_name || c.name || c.value)
+                        .filter(Boolean);
+                    if (companies.length > 0) {
+                        details += `Company: ${companies.join(', ')}\n`;
+                    }
+                }
+            }
+            fieldOrder.forEach((field) => {
+                const value = record.values?.[field] &&
+                    Array.isArray(record.values[field]) &&
+                    record.values[field][0]?.value;
+                if (value) {
+                    const displayField = field.charAt(0).toUpperCase() + field.slice(1).replace(/_/g, ' ');
+                    details += `${displayField}: ${value}\n`;
+                }
+            });
+            if (record.values?.domains && Array.isArray(record.values.domains)) {
+                const domains = record.values.domains
+                    .map((d) => d.domain)
+                    .filter(Boolean);
+                if (domains.length > 0) {
+                    details += `Domains: ${domains.join(', ')}\n`;
+                }
+            }
+            if (resourceType === UniversalResourceType.PEOPLE) {
+                if (record.values.email_addresses &&
+                    Array.isArray(record.values.email_addresses)) {
+                    const emails = record.values.email_addresses
+                        .map((e) => e.email_address || e.value)
+                        .filter(Boolean);
+                    if (emails.length > 0) {
+                        details += `Email: ${emails.join(', ')}\n`;
+                    }
+                }
+                if (record.values.phone_numbers &&
+                    Array.isArray(record.values.phone_numbers)) {
+                    const phones = record.values.phone_numbers
+                        .map((p) => p.phone_number || p.value)
+                        .filter(Boolean);
+                    if (phones.length > 0) {
+                        details += `Phone: ${phones.join(', ')}\n`;
+                    }
+                }
+            }
+            if (record.values.created_at &&
+                Array.isArray(record.values.created_at) &&
+                record.values.created_at[0]?.value) {
+                details += `Created at: ${record.values.created_at[0].value}\n`;
+            }
+        }
+        return details.trim();
+    },
+    structuredOutput: (record, resourceType) => {
+        if (!record)
+            return {};
+        const result = { ...record };
+        // Normalize company name to string for consistency
+        if (resourceType === 'companies' && record.values) {
+            const values = record.values;
+            const nameArray = values.name;
+            if (Array.isArray(nameArray) && nameArray[0]?.value) {
+                result.values = {
+                    ...values,
+                    name: nameArray[0].value,
+                };
+            }
+        }
+        return result;
+    },
+};
+export const getRecordDetailsDefinition = {
+    name: 'get_record_details',
+    description: formatToolDescription({
+        capability: 'Fetch a single record with enriched attribute formatting.',
+        boundaries: 'search or filter result sets; use records.search* tools instead.',
+        constraints: 'Requires resource_type and record_id; optional fields filter output.',
+        recoveryHint: 'Validate record IDs with records.search before retrying.',
+    }),
+    inputSchema: getRecordDetailsSchema,
+    annotations: {
+        readOnlyHint: true,
+        idempotentHint: true,
+    },
+};
+//# sourceMappingURL=record-details-operations.js.map

package/dist/handlers/tool-configs/universal/core/record-details-operations.js.map

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

package/dist/handlers/tool-configs/universal/core/search-operations.d.ts

@@ -0,0 +1,137 @@
+import { UniversalToolConfig, UniversalSearchParams } from '../types.js';
+import { AttioRecord } from '../../../../types/attio.js';
+/**
+ * Universal search records tool configuration.
+ * Consolidates: search-companies, search-people, list-records, list-tasks.
+ */
+export declare const searchRecordsConfig: UniversalToolConfig<UniversalSearchParams, AttioRecord[]>;
+export declare const searchRecordsDefinition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            limit: {
+                type: "number";
+                minimum: number;
+                maximum: number;
+                default: number;
+                description: string;
+            };
+            offset: {
+                type: "number";
+                minimum: number;
+                default: number;
+                description: string;
+            };
+            resource_type: {
+                type: "string";
+                description: string;
+            };
+            query: {
+                type: "string";
+                description: string;
+            };
+            filters: {
+                type: "object";
+                description: string;
+                additionalProperties: boolean;
+            };
+            search_type: {
+                type: "string";
+                enum: readonly ["basic", "content", "timeframe"];
+                description: string;
+            };
+            fields: {
+                type: "array";
+                items: {
+                    type: "string";
+                };
+                description: string;
+            };
+            match_type: {
+                type: "string";
+                enum: readonly ["exact", "partial", "fuzzy"];
+                description: string;
+            };
+            sort: {
+                type: "string";
+                enum: readonly ["relevance", "created", "modified", "name"];
+                description: string;
+            };
+            date_from: {
+                type: "string";
+                description: string;
+                format: string;
+            };
+            date_to: {
+                type: "string";
+                description: string;
+                format: string;
+            };
+            created_after: {
+                type: "string";
+                description: string;
+                format: string;
+            };
+            created_before: {
+                type: "string";
+                description: string;
+                format: string;
+            };
+            updated_after: {
+                type: "string";
+                description: string;
+                format: string;
+            };
+            updated_before: {
+                type: "string";
+                description: string;
+                format: string;
+            };
+            timeframe: {
+                type: "string";
+                enum: readonly ["today", "yesterday", "this_week", "last_week", "this_month", "last_month", "last_7_days", "last_30_days", "last_90_days"];
+                description: string;
+            };
+            date_field: {
+                type: "string";
+                enum: readonly ["created_at", "updated_at"];
+                default: string;
+                description: string;
+            };
+        };
+        required: "resource_type"[];
+        additionalProperties: boolean;
+        examples: ({
+            resource_type: string;
+            query: string;
+            limit: number;
+            filters?: undefined;
+        } | {
+            resource_type: string;
+            filters: {
+                filters: ({
+                    attribute: {
+                        slug: string;
+                    };
+                    condition: string;
+                    value: string;
+                } | {
+                    attribute: {
+                        slug: string;
+                    };
+                    condition: string;
+                    value: number;
+                })[];
+            };
+            limit: number;
+            query?: undefined;
+        })[];
+    };
+    annotations: {
+        readOnlyHint: boolean;
+        idempotentHint: boolean;
+    };
+};
+//# sourceMappingURL=search-operations.d.ts.map

package/dist/handlers/tool-configs/universal/core/search-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-operations.d.ts","sourceRoot":"","sources":["../../../../../src/handlers/tool-configs/universal/core/search-operations.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EAEtB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAUzD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,mBAAmB,CACnD,qBAAqB,EACrB,WAAW,EAAE,CAmId,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAanC,CAAC"}