attio-mcp 0.1.1 → 1.0.0

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

@@ -0,0 +1,188 @@
+import { getAttributesSchema, discoverAttributesSchema, validateUniversalToolParams, } from '../schemas.js';
+import { handleUniversalGetAttributes, handleUniversalDiscoverAttributes, getSingularResourceType, } from '../shared-handlers.js';
+export const getAttributesConfig = {
+    name: 'get-attributes',
+    handler: async (params) => {
+        try {
+            const sanitizedParams = validateUniversalToolParams('get-attributes', params);
+            return await handleUniversalGetAttributes(sanitizedParams);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return { error: errorMessage, success: false };
+        }
+    },
+    formatResult: (attributes, ...args) => {
+        const resourceType = args[0];
+        if (!attributes) {
+            return 'No attributes found';
+        }
+        const resourceTypeName = resourceType
+            ? getSingularResourceType(resourceType)
+            : 'record';
+        if (Array.isArray(attributes)) {
+            return `${resourceTypeName.charAt(0).toUpperCase() + resourceTypeName.slice(1)} attributes (${attributes.length}):\n${attributes
+                .map((attr, index) => {
+                const name = attr.title || attr.api_slug || attr.name || attr.slug || 'Unnamed';
+                const type = attr.type || 'unknown';
+                return `${index + 1}. ${name} (${type})`;
+            })
+                .join('\n')}`;
+        }
+        if (typeof attributes === 'object' && attributes !== null) {
+            if (attributes.all && Array.isArray(attributes.all)) {
+                return `Available ${resourceTypeName} attributes (${attributes.all.length}):\n${attributes.all
+                    .map((attr, index) => {
+                    const name = attr.title ||
+                        attr.api_slug ||
+                        attr.name ||
+                        attr.slug ||
+                        'Unnamed';
+                    const type = attr.type || 'unknown';
+                    return `${index + 1}. ${name} (${type})`;
+                })
+                    .join('\n')}`;
+            }
+            if (attributes.attributes && Array.isArray(attributes.attributes)) {
+                return `Available ${resourceTypeName} attributes (${attributes.attributes.length}):\n${attributes.attributes
+                    .map((attr, index) => {
+                    const name = attr.name || attr.api_slug || attr.slug || 'Unnamed';
+                    const type = attr.type || 'unknown';
+                    return `${index + 1}. ${name} (${type})`;
+                })
+                    .join('\n')}`;
+            }
+            const keys = Object.keys(attributes);
+            if (keys.length > 0) {
+                return `${resourceTypeName.charAt(0).toUpperCase() + resourceTypeName.slice(1)} attributes (${keys.length}):\n${keys
+                    .map((key, index) => {
+                    const value = attributes[key];
+                    if (typeof value === 'string') {
+                        return `${index + 1}. ${key}: "${value}"`;
+                    }
+                    return `${index + 1}. ${key}`;
+                })
+                    .join('\n')}`;
+            }
+        }
+        return `${resourceTypeName.charAt(0).toUpperCase() + resourceTypeName.slice(1)} attributes available`;
+    },
+};
+export const discoverAttributesConfig = {
+    name: 'discover-attributes',
+    handler: async (params) => {
+        try {
+            const sanitizedParams = validateUniversalToolParams('discover-attributes', params);
+            return await handleUniversalDiscoverAttributes(sanitizedParams.resource_type, {
+                categories: sanitizedParams.categories,
+            });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return { error: errorMessage, success: false };
+        }
+    },
+    formatResult: (schema, ...args) => {
+        const resourceType = args[0];
+        if (!schema) {
+            return 'No attribute schema found';
+        }
+        const resourceTypeName = resourceType
+            ? getSingularResourceType(resourceType)
+            : 'record';
+        if (Array.isArray(schema)) {
+            return `Available ${resourceTypeName} attributes (${schema.length}):\n${schema
+                .map((attr, index) => {
+                const name = attr.title || attr.api_slug || attr.name || attr.slug || 'Unnamed';
+                const type = attr.type || 'unknown';
+                const required = attr.required ? ' (required)' : '';
+                return `${index + 1}. ${name} (${type})${required}`;
+            })
+                .join('\n')}`;
+        }
+        if (typeof schema === 'object' && schema !== null) {
+            const schemaRecord = schema;
+            if (schemaRecord.all && Array.isArray(schemaRecord.all)) {
+                return `Available ${resourceTypeName} attributes (${schemaRecord.all.length}):\n${schemaRecord.all
+                    .map((attr, index) => {
+                    const name = attr.title ||
+                        attr.api_slug ||
+                        attr.name ||
+                        attr.slug ||
+                        'Unnamed';
+                    const type = attr.type || 'unknown';
+                    const required = attr.required ? ' (required)' : '';
+                    return `${index + 1}. ${name} (${type})${required}`;
+                })
+                    .join('\n')}`;
+            }
+            if (schemaRecord.attributes && Array.isArray(schemaRecord.attributes)) {
+                return `Available ${resourceTypeName} attributes (${schemaRecord.attributes.length}):\n${schemaRecord.attributes
+                    .map((attr, index) => {
+                    const name = attr.title ||
+                        attr.api_slug ||
+                        attr.name ||
+                        attr.slug ||
+                        'Unnamed';
+                    const type = attr.type || 'unknown';
+                    const required = attr.required ? ' (required)' : '';
+                    return `${index + 1}. ${name} (${type})${required}`;
+                })
+                    .join('\n')}`;
+            }
+            if (schemaRecord.standard || schemaRecord.custom) {
+                const standard = schemaRecord.standard || [];
+                const custom = schemaRecord.custom || [];
+                const total = standard.length + custom.length;
+                let result = `Available ${resourceTypeName} attributes (${total} total):\n`;
+                if (standard.length > 0) {
+                    result += `\nStandard attributes (${standard.length}):\n${standard
+                        .map((attr, index) => {
+                        const name = attr.title ||
+                            attr.api_slug ||
+                            attr.name ||
+                            attr.slug ||
+                            'Unnamed';
+                        const type = attr.type || 'unknown';
+                        return `${index + 1}. ${name} (${type})`;
+                    })
+                        .join('\n')}`;
+                }
+                if (custom.length > 0) {
+                    result += `\n\nCustom attributes (${custom.length}):\n${custom
+                        .map((attr, index) => {
+                        const name = attr.title ||
+                            attr.api_slug ||
+                            attr.name ||
+                            attr.slug ||
+                            'Unnamed';
+                        const type = attr.type || 'unknown';
+                        return `${standard.length + index + 1}. ${name} (${type})`;
+                    })
+                        .join('\n')}`;
+                }
+                return result;
+            }
+        }
+        return `${resourceTypeName.charAt(0).toUpperCase() + resourceTypeName.slice(1)} attribute schema available`;
+    },
+};
+export const getAttributesDefinition = {
+    name: 'get-attributes',
+    description: 'Get attributes for any resource type (companies, people, lists, records, tasks, deals, notes)',
+    inputSchema: getAttributesSchema,
+    annotations: {
+        readOnlyHint: true,
+        idempotentHint: true,
+    },
+};
+export const discoverAttributesDefinition = {
+    name: 'discover-attributes',
+    description: 'Discover available attributes for any resource type',
+    inputSchema: discoverAttributesSchema,
+    annotations: {
+        readOnlyHint: true,
+        idempotentHint: true,
+    },
+};
+//# sourceMappingURL=metadata-operations.js.map

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

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

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

@@ -0,0 +1,77 @@
+import { UniversalToolConfig } from '../types.js';
+export declare const createNoteConfig: UniversalToolConfig<Record<string, unknown>, Record<string, unknown>>;
+export declare const listNotesConfig: UniversalToolConfig<Record<string, unknown>, Record<string, unknown>[]>;
+export declare const createNoteDefinition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            resource_type: {
+                type: "string";
+                enum: import("../types.js").UniversalResourceType[];
+                description: string;
+            };
+            record_id: {
+                type: "string";
+                description: string;
+            };
+            title: {
+                type: "string";
+                description: string;
+            };
+            content: {
+                type: "string";
+                description: string;
+            };
+        };
+        required: ("record_id" | "title" | "content" | "resource_type")[];
+        additionalProperties: boolean;
+    };
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+    };
+};
+export declare const listNotesDefinition: {
+    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";
+                enum: import("../types.js").UniversalResourceType[];
+                description: string;
+            };
+            record_id: {
+                type: "string";
+                description: string;
+            };
+            parent_record_id: {
+                type: "string";
+                description: string;
+            };
+        };
+        required: "resource_type"[];
+        additionalProperties: boolean;
+    };
+    annotations: {
+        readOnlyHint: boolean;
+        idempotentHint: boolean;
+    };
+};
+//# sourceMappingURL=notes-operations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"notes-operations.d.ts","sourceRoot":"","sources":["../../../../../src/handlers/tool-configs/universal/core/notes-operations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAYlD,eAAO,MAAM,gBAAgB,EAAE,mBAAmB,CAChD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAwDxB,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,mBAAmB,CAC/C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAgD1B,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAQhC,CAAC;AAEF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAQ/B,CAAC"}

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

@@ -0,0 +1,97 @@
+import { createNoteSchema, listNotesSchema, validateUniversalToolParams, } from '../schemas.js';
+import { handleUniversalCreateNote, handleUniversalGetNotes, } from '../shared-handlers.js';
+import { ErrorService } from '../../../../services/ErrorService.js';
+export const createNoteConfig = {
+    name: 'create-note',
+    handler: async (params) => {
+        try {
+            const sanitizedParams = validateUniversalToolParams('create-note', params);
+            const res = await handleUniversalCreateNote(sanitizedParams);
+            return res;
+        }
+        catch (err) {
+            const error = err;
+            const status = error?.response?.status;
+            const body = error?.response?.data;
+            const upstreamMsg = body?.error?.message ||
+                body?.message ||
+                (typeof body?.error === 'string' ? body.error : undefined);
+            const mapped = status === 404
+                ? 'record not found'
+                : status === 400 || status === 422
+                    ? 'invalid or missing required parameter'
+                    : upstreamMsg || 'invalid request';
+            return { isError: true, error: mapped };
+        }
+    },
+    formatResult: (note) => {
+        if (!note) {
+            return 'No note created';
+        }
+        const title = note.title ||
+            note.values?.title?.[0]?.value ||
+            'Untitled';
+        const content = note.content ||
+            note.values?.content?.[0]?.value ||
+            '';
+        const id = note.id?.record_id || note.id || 'unknown';
+        return `✅ Note created successfully: ${title} (ID: ${id})${content ? `\n${content}` : ''}`;
+    },
+};
+export const listNotesConfig = {
+    name: 'list-notes',
+    handler: async (params) => {
+        try {
+            const sanitizedParams = validateUniversalToolParams('list-notes', params);
+            return await handleUniversalGetNotes(sanitizedParams);
+        }
+        catch (error) {
+            throw ErrorService.createUniversalError('list-notes', 'notes', error);
+        }
+    },
+    formatResult: (notes) => {
+        const notesArray = notes || [];
+        if (notesArray.length === 0) {
+            return 'Found 0 notes';
+        }
+        const formattedNotes = notesArray
+            .map((note, index) => {
+            const title = note.title ||
+                note.values?.title?.[0]?.value ||
+                'Untitled';
+            const content = note.content ||
+                note.values?.content?.[0]
+                    ?.value ||
+                '';
+            const id = note.id?.record_id || note.id || 'unknown';
+            const timestamp = note.created_at ||
+                note.timestamp ||
+                'unknown date';
+            const preview = content.length > 50
+                ? content.substring(0, 50) + '...'
+                : content;
+            return `${index + 1}. ${title} (${timestamp}) (ID: ${id})${preview ? `\n   ${preview}` : ''}`;
+        })
+            .join('\n\n');
+        return `Found ${notesArray.length} notes:\n${formattedNotes}`;
+    },
+};
+export const createNoteDefinition = {
+    name: 'create-note',
+    description: 'Create a note for any record type (companies, people, deals)',
+    inputSchema: createNoteSchema,
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+    },
+};
+export const listNotesDefinition = {
+    name: 'list-notes',
+    description: 'Get notes for any record type (companies, people, deals)',
+    inputSchema: listNotesSchema,
+    annotations: {
+        readOnlyHint: true,
+        idempotentHint: true,
+    },
+};
+//# sourceMappingURL=notes-operations.js.map

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

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

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

@@ -0,0 +1,41 @@
+/**
+ * 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';
+/**
+ * Check if a field name indicates it might contain PII
+ */
+export declare const isPotentialPIIField: (fieldName: string) => boolean;
+/**
+ * Sanitize a string value for PII
+ */
+export declare const sanitizeStringValue: (value: string) => string;
+/**
+ * Sanitize any value (string, object, array) for PII
+ */
+export declare const sanitizeValue: (value: unknown) => unknown;
+/**
+ * Sanitize validation metadata to remove PII
+ */
+export interface SanitizedValidationMetadata {
+    warnings?: string[];
+    suggestions?: string[];
+    actualValues?: Record<string, unknown>;
+}
+export declare const sanitizeValidationMetadata: (metadata?: {
+    warnings?: string[];
+    suggestions?: string[];
+    actualValues?: Record<string, unknown>;
+}) => SanitizedValidationMetadata | undefined;
+/**
+ * Enhanced format function with PII sanitization
+ */
+export declare const formatSanitizedActualValue: (value: unknown) => string;
+/**
+ * Safe logging function that sanitizes messages before logging
+ */
+export declare const sanitizedLog: (logger: ReturnType<typeof createScopedLogger>, level: "error" | "warn" | "info" | "debug", message: string, data?: Record<string, unknown>) => void;
+//# sourceMappingURL=pii-sanitizer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pii-sanitizer.d.ts","sourceRoot":"","sources":["../../../../../src/handlers/tool-configs/universal/core/pii-sanitizer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAyFjE;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAAI,WAAW,MAAM,KAAG,OAmBvD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAAI,OAAO,MAAM,KAAG,MAoBnD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,KAAG,OAwC9C,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED,eAAO,MAAM,0BAA0B,GAAI,WAAW;IACpD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC,KAAG,2BAA2B,GAAG,SAyCjC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,0BAA0B,GAAI,OAAO,OAAO,KAAG,MAoB3D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,GACvB,QAAQ,UAAU,CAAC,OAAO,kBAAkB,CAAC,EAC7C,OAAO,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,EAC1C,SAAS,MAAM,EACf,OAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7B,IAUF,CAAC"}

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