@iflow-mcp/attio-mcp 1.3.6

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

@@ -0,0 +1,128 @@
+import { UniversalResourceType, } from '../types.js';
+import { getPluralResourceType } from './utils.js';
+import { validateUniversalToolParams, searchRecordsSchema, } from '../schemas.js';
+import { handleSearchError } from './error-utils.js';
+import { handleUniversalSearch } from '../shared-handlers.js';
+import { formatToolDescription } from '../../../../handlers/tools/standards/index.js';
+/**
+ * Universal search records tool configuration.
+ * Consolidates: search-companies, search-people, list-records, list-tasks.
+ */
+export const searchRecordsConfig = {
+    name: 'search_records',
+    handler: async (params) => {
+        try {
+            const sanitizedParams = validateUniversalToolParams('search_records', params);
+            return await handleUniversalSearch(sanitizedParams);
+        }
+        catch (error) {
+            return await handleSearchError(error, params.resource_type, params);
+        }
+    },
+    formatResult: (results, ...args) => {
+        const resourceType = args[0];
+        if (!results) {
+            const typeName = resourceType
+                ? getPluralResourceType(resourceType)
+                : 'records';
+            return `Found 0 ${typeName}`;
+        }
+        const recordsArray = Array.isArray(results)
+            ? results
+            : (results?.data ?? []);
+        if (!Array.isArray(recordsArray) || recordsArray.length === 0) {
+            const typeName = resourceType
+                ? getPluralResourceType(resourceType)
+                : 'records';
+            return `Found 0 ${typeName}`;
+        }
+        const typeName = resourceType
+            ? getPluralResourceType(resourceType)
+            : 'records';
+        const formattedResults = recordsArray
+            .map((record, index) => {
+            let identifier = 'Unnamed';
+            let id = String(record.id?.record_id || 'unknown');
+            const values = record.values || {};
+            const getFirstValue = (field) => {
+                if (!field || !Array.isArray(field) || field.length === 0)
+                    return undefined;
+                const firstItem = field[0];
+                return firstItem &&
+                    typeof firstItem === 'object' &&
+                    firstItem !== null &&
+                    'value' in firstItem
+                    ? String(firstItem.value)
+                    : undefined;
+            };
+            if (resourceType === UniversalResourceType.TASKS) {
+                identifier =
+                    typeof values.content === 'string'
+                        ? values.content
+                        : getFirstValue(values.content) || 'Unnamed';
+                id = String(record.id?.task_id || record.id?.record_id || 'unknown');
+            }
+            else if (resourceType === UniversalResourceType.PEOPLE) {
+                const valuesAny = values;
+                const name = valuesAny?.name?.[0]
+                    ?.full_name ||
+                    valuesAny?.name?.[0]?.value ||
+                    valuesAny?.name?.[0]
+                        ?.formatted ||
+                    valuesAny?.full_name?.[0]
+                        ?.value ||
+                    getFirstValue(values.name) ||
+                    'Unnamed';
+                const emailValue = valuesAny?.email_addresses?.[0]?.email_address ||
+                    valuesAny?.email_addresses?.[0]?.value ||
+                    getFirstValue(values.email) ||
+                    getFirstValue(valuesAny.email_addresses);
+                identifier = emailValue ? `${name} (${emailValue})` : name;
+            }
+            else if (resourceType === UniversalResourceType.COMPANIES) {
+                const name = typeof values.name === 'string'
+                    ? values.name
+                    : getFirstValue(values.name) || 'Unnamed';
+                const website = getFirstValue(values.website);
+                const domain = values.domains &&
+                    Array.isArray(values.domains) &&
+                    values.domains.length > 0
+                    ? values.domains[0].domain
+                    : undefined;
+                const email = getFirstValue(values.email);
+                const contactInfo = website || domain || email;
+                identifier = contactInfo ? `${name} (${contactInfo})` : name;
+            }
+            else {
+                const nameValue = getFirstValue(values.name);
+                const titleValue = getFirstValue(values.title);
+                identifier = nameValue || titleValue || 'Unnamed';
+            }
+            return `${index + 1}. ${identifier} (ID: ${id})`;
+        })
+            .join('\n');
+        return `Found ${recordsArray.length} ${typeName}:\n${formattedResults}`;
+    },
+    structuredOutput: (results) => {
+        // Return the raw records array for JSON parsing
+        const recordsArray = Array.isArray(results)
+            ? results
+            : (results?.data ?? []);
+        return { data: recordsArray, count: recordsArray.length };
+    },
+};
+export const searchRecordsDefinition = {
+    name: 'search_records',
+    description: formatToolDescription({
+        capability: 'Search across companies, people, deals, tasks, and records',
+        boundaries: 'create or modify records',
+        constraints: 'Returns max 100 results (default: 10)',
+        recoveryHint: 'use discover_record_attributes to find searchable fields',
+    }),
+    inputSchema: searchRecordsSchema,
+    annotations: {
+        readOnlyHint: true,
+        idempotentHint: true,
+    },
+};
+//# sourceMappingURL=search-operations.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search-operations.js","sourceRoot":"","sources":["../../../../../src/handlers/tool-configs/universal/core/search-operations.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EACL,2BAA2B,EAC3B,mBAAmB,GACpB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAE5E;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAG5B;IACF,IAAI,EAAE,gBAAgB;IACtB,OAAO,EAAE,KAAK,EAAE,MAA6B,EAA0B,EAAE;QACvE,IAAI,CAAC;YACH,MAAM,eAAe,GAAG,2BAA2B,CACjD,gBAAgB,EAChB,MAAM,CACP,CAAC;YACF,OAAO,MAAM,qBAAqB,CAAC,eAAe,CAAC,CAAC;QACtD,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,OAAO,MAAM,iBAAiB,CAC5B,KAAK,EACL,MAAM,CAAC,aAAa,EACpB,MAA4C,CAC7C,CAAC;QACJ,CAAC;IACH,CAAC;IACD,YAAY,EAAE,CACZ,OAAgD,EAChD,GAAG,IAAe,EACV,EAAE;QACV,MAAM,YAAY,GAAG,IAAI,CAAC,CAAC,CAAsC,CAAC;QAClE,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,QAAQ,GAAG,YAAY;gBAC3B,CAAC,CAAC,qBAAqB,CAAC,YAAY,CAAC;gBACrC,CAAC,CAAC,SAAS,CAAC;YACd,OAAO,WAAW,QAAQ,EAAE,CAAC;QAC/B,CAAC;QAED,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;YACzC,CAAC,CAAC,OAAO;YACT,CAAC,CAAC,CAAC,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;QAE1B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9D,MAAM,QAAQ,GAAG,YAAY;gBAC3B,CAAC,CAAC,qBAAqB,CAAC,YAAY,CAAC;gBACrC,CAAC,CAAC,SAAS,CAAC;YACd,OAAO,WAAW,QAAQ,EAAE,CAAC;QAC/B,CAAC;QAED,MAAM,QAAQ,GAAG,YAAY;YAC3B,CAAC,CAAC,qBAAqB,CAAC,YAAY,CAAC;YACrC,CAAC,CAAC,SAAS,CAAC;QAEd,MAAM,gBAAgB,GAAG,YAAY;aAClC,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;YACrB,IAAI,UAAU,GAAG,SAAS,CAAC;YAC3B,IAAI,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,IAAI,SAAS,CAAC,CAAC;YAEnD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;YACnC,MAAM,aAAa,GAAG,CAAC,KAAc,EAAsB,EAAE;gBAC3D,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;oBACvD,OAAO,SAAS,CAAC;gBACnB,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAuB,CAAC;gBACjD,OAAO,SAAS;oBACd,OAAO,SAAS,KAAK,QAAQ;oBAC7B,SAAS,KAAK,IAAI;oBAClB,OAAO,IAAI,SAAS;oBACpB,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC;oBACzB,CAAC,CAAC,SAAS,CAAC;YAChB,CAAC,CAAC;YAEF,IAAI,YAAY,KAAK,qBAAqB,CAAC,KAAK,EAAE,CAAC;gBACjD,UAAU;oBACR,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ;wBAChC,CAAC,CAAC,MAAM,CAAC,OAAO;wBAChB,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,SAAS,CAAC;gBACjD,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,IAAI,MAAM,CAAC,EAAE,EAAE,SAAS,IAAI,SAAS,CAAC,CAAC;YACvE,CAAC;iBAAM,IAAI,YAAY,KAAK,qBAAqB,CAAC,MAAM,EAAE,CAAC;gBACzD,MAAM,SAAS,GAAG,MAAiC,CAAC;gBACpD,MAAM,IAAI,GACP,SAAS,EAAE,IAA6C,EAAE,CAAC,CAAC,CAAC;oBAC5D,EAAE,SAAS;oBACZ,SAAS,EAAE,IAAyC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK;oBAChE,SAAS,EAAE,IAA6C,EAAE,CAAC,CAAC,CAAC;wBAC5D,EAAE,SAAS;oBACZ,SAAS,EAAE,SAA8C,EAAE,CAAC,CAAC,CAAC;wBAC7D,EAAE,KAAK;oBACT,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC;oBAC1B,SAAS,CAAC;gBAEZ,MAAM,UAAU,GAEZ,SAAS,EAAE,eAGZ,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa;oBAEnB,SAAS,EAAE,eACZ,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK;oBACb,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC;oBAC3B,aAAa,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;gBAE3C,UAAU,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,UAAU,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;YAC7D,CAAC;iBAAM,IAAI,YAAY,KAAK,qBAAqB,CAAC,SAAS,EAAE,CAAC;gBAC5D,MAAM,IAAI,GACR,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;oBAC7B,CAAC,CAAC,MAAM,CAAC,IAAI;oBACb,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC;gBAC9C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBAC9C,MAAM,MAAM,GACV,MAAM,CAAC,OAAO;oBACd,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;oBAC7B,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;oBACvB,CAAC,CAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAyB,CAAC,MAAM;oBACnD,CAAC,CAAC,SAAS,CAAC;gBAChB,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC1C,MAAM,WAAW,GAAG,OAAO,IAAI,MAAM,IAAI,KAAK,CAAC;gBAC/C,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,WAAW,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;YAC/D,CAAC;iBAAM,CAAC;gBACN,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBAC7C,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC/C,UAAU,GAAG,SAAS,IAAI,UAAU,IAAI,SAAS,CAAC;YACpD,CAAC;YAED,OAAO,GAAG,KAAK,GAAG,CAAC,KAAK,UAAU,SAAS,EAAE,GAAG,CAAC;QACnD,CAAC,CAAC;aACD,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,OAAO,SAAS,YAAY,CAAC,MAAM,IAAI,QAAQ,MAAM,gBAAgB,EAAE,CAAC;IAC1E,CAAC;IACD,gBAAgB,EAAE,CAChB,OAAgD,EACvB,EAAE;QAC3B,gDAAgD;QAChD,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;YACzC,CAAC,CAAC,OAAO;YACT,CAAC,CAAC,CAAC,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;QAC1B,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,CAAC,MAAM,EAAE,CAAC;IAC5D,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE,qBAAqB,CAAC;QACjC,UAAU,EAAE,4DAA4D;QACxE,UAAU,EAAE,0BAA0B;QACtC,WAAW,EAAE,uCAAuC;QACpD,YAAY,EAAE,0DAA0D;KACzE,CAAC;IACF,WAAW,EAAE,mBAAmB;IAChC,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;QAClB,cAAc,EAAE,IAAI;KACrB;CACF,CAAC"}

package/dist/handlers/tool-configs/universal/core/utils/note-formatters.d.ts

@@ -0,0 +1,14 @@
+export interface NoteFields {
+    title: string;
+    content: string;
+    id: string;
+    timestamp: string;
+    preview: string;
+}
+/**
+ * Normalize note fields from multiple potential Attio response shapes.
+ */
+export declare const extractNoteFields: (note: Record<string, unknown> | undefined, options?: {
+    previewLength?: number;
+}) => NoteFields;
+//# sourceMappingURL=note-formatters.d.ts.map

package/dist/handlers/tool-configs/universal/core/utils/note-formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"note-formatters.d.ts","sourceRoot":"","sources":["../../../../../../src/handlers/tool-configs/universal/core/utils/note-formatters.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAqED;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EACzC,UAAU;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,KACnC,UA8CF,CAAC"}

package/dist/handlers/tool-configs/universal/core/utils/note-formatters.js

@@ -0,0 +1,92 @@
+const DEFAULT_PREVIEW_LENGTH = 50;
+const toStringValue = (value) => {
+    if (typeof value === 'string' && value.trim().length > 0) {
+        return value;
+    }
+    return undefined;
+};
+const toNoteIdentifier = (id) => {
+    if (!id || typeof id !== 'object') {
+        return undefined;
+    }
+    const candidate = id;
+    const hasUsableField = ['note_id', 'record_id', 'id'].some((key) => {
+        const value = candidate[key];
+        return typeof value === 'string' && value.trim().length > 0;
+    });
+    if (!hasUsableField) {
+        return undefined;
+    }
+    return candidate;
+};
+const fromValuesArray = (values) => {
+    if (!Array.isArray(values) || values.length === 0) {
+        return undefined;
+    }
+    for (const entry of values) {
+        const value = toStringValue(entry?.value ?? entry?.full_name);
+        if (value) {
+            return value;
+        }
+    }
+    return undefined;
+};
+const extractFromNoteValues = (values, field) => {
+    if (!values) {
+        return undefined;
+    }
+    const fieldValue = values[field];
+    if (!fieldValue) {
+        return undefined;
+    }
+    if (Array.isArray(fieldValue)) {
+        return fromValuesArray(fieldValue);
+    }
+    if (fieldValue &&
+        typeof fieldValue === 'object' &&
+        'value' in fieldValue &&
+        typeof fieldValue.value === 'string') {
+        return String(fieldValue.value);
+    }
+    return undefined;
+};
+/**
+ * Normalize note fields from multiple potential Attio response shapes.
+ */
+export const extractNoteFields = (note, options) => {
+    const attioNote = (note ?? {});
+    const title = toStringValue(attioNote.title) ||
+        extractFromNoteValues(attioNote.values, 'title') ||
+        'Untitled';
+    const content = toStringValue(attioNote.content) ||
+        toStringValue(attioNote.content_markdown) ||
+        toStringValue(attioNote.content_plaintext) ||
+        extractFromNoteValues(attioNote.values, 'content') ||
+        '';
+    const noteId = toNoteIdentifier(attioNote.id);
+    const id = toStringValue(attioNote.record_id) ||
+        toStringValue(attioNote.note_id) ||
+        (typeof attioNote.id === 'string'
+            ? toStringValue(attioNote.id)
+            : undefined) ||
+        toStringValue(noteId?.record_id) ||
+        toStringValue(noteId?.note_id) ||
+        toStringValue(noteId?.id) ||
+        'unknown';
+    const timestamp = toStringValue(attioNote.created_at) ||
+        toStringValue(attioNote.timestamp) ||
+        'unknown date';
+    const previewLength = options?.previewLength ?? DEFAULT_PREVIEW_LENGTH;
+    const trimmedContent = content.trim();
+    const preview = trimmedContent.length > previewLength
+        ? `${trimmedContent.slice(0, previewLength)}...`
+        : trimmedContent;
+    return {
+        title,
+        content,
+        id,
+        timestamp,
+        preview,
+    };
+};
+//# sourceMappingURL=note-formatters.js.map

package/dist/handlers/tool-configs/universal/core/utils/note-formatters.js.map

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

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

@@ -0,0 +1,13 @@
+import { UniversalResourceType } from '../types.js';
+/**
+ * Return plural form label for universal resource types. Used solely for result formatting.
+ */
+export declare function getPluralResourceType(resourceType: UniversalResourceType): string;
+export declare const extractDisplayName: (values: Record<string, unknown> | undefined, resourceType?: UniversalResourceType) => string;
+export interface ValidationMetadata {
+    warnings?: string[];
+    suggestions?: string[];
+    actualValues?: Record<string, unknown>;
+}
+export declare const formatValidationDetails: (metadata?: ValidationMetadata) => string;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../../src/handlers/tool-configs/universal/core/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAcpD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,qBAAqB,GAClC,MAAM,CAmBR;AAQD,eAAO,MAAM,kBAAkB,+FAA0B,CAAC;AAE1D,MAAM,WAAW,kBAAkB;IACjC,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;AAOD,eAAO,MAAM,uBAAuB,GAClC,WAAW,kBAAkB,KAC5B,MA8CF,CAAC"}

package/dist/handlers/tool-configs/universal/core/utils.js

@@ -0,0 +1,68 @@
+import { UniversalResourceType } from '../types.js';
+import { extractDisplayName as extractDisplayNameTyped, coerceArrayValue as legacyCoerceArrayValue, coerceScalar as legacyCoerceScalar, } from './value-extractors.js';
+import { sanitizeValidationMetadata, formatSanitizedActualValue, } from './pii-sanitizer.js';
+/**
+ * Return plural form label for universal resource types. Used solely for result formatting.
+ */
+export function getPluralResourceType(resourceType) {
+    switch (resourceType) {
+        case UniversalResourceType.COMPANIES:
+            return 'companies';
+        case UniversalResourceType.PEOPLE:
+            return 'people';
+        case UniversalResourceType.LISTS:
+            return 'lists';
+        case UniversalResourceType.RECORDS:
+            return 'records';
+        case UniversalResourceType.DEALS:
+            return 'deals';
+        case UniversalResourceType.TASKS:
+            return 'tasks';
+        case UniversalResourceType.NOTES:
+            return 'notes';
+        default:
+            return 'records';
+    }
+}
+// Legacy functions maintained for backward compatibility
+// @deprecated Use extractDisplayValue from value-extractors.ts instead
+const coerceArrayValue = legacyCoerceArrayValue;
+const coerceScalar = legacyCoerceScalar;
+// Use the new type-safe extraction function
+export const extractDisplayName = extractDisplayNameTyped;
+const formatActualValue = (value) => {
+    // Use PII-sanitized formatting
+    return formatSanitizedActualValue(value);
+};
+export const formatValidationDetails = (metadata) => {
+    if (!metadata)
+        return '';
+    // Sanitize metadata before processing
+    const sanitizedMetadata = sanitizeValidationMetadata(metadata);
+    if (!sanitizedMetadata)
+        return '';
+    const sections = [];
+    if (sanitizedMetadata.warnings?.length) {
+        sections.push([
+            'Warnings:',
+            ...sanitizedMetadata.warnings.map((warning) => `• ${warning}`),
+        ].join('\n'));
+    }
+    const uniqueSuggestions = sanitizedMetadata.suggestions?.filter((suggestion) => sanitizedMetadata.warnings
+        ? !sanitizedMetadata.warnings.includes(suggestion)
+        : true);
+    if (uniqueSuggestions && uniqueSuggestions.length > 0) {
+        sections.push([
+            'Suggestions:',
+            ...uniqueSuggestions.map((suggestion) => `• ${suggestion}`),
+        ].join('\n'));
+    }
+    if (sanitizedMetadata.warnings?.length &&
+        sanitizedMetadata.actualValues &&
+        Object.keys(sanitizedMetadata.actualValues).length > 0) {
+        const actualLines = Object.entries(sanitizedMetadata.actualValues).map(([key, value]) => `• ${key}: ${formatActualValue(value)}`);
+        sections.push(['Actual persisted values:', ...actualLines].join('\n'));
+    }
+    return sections.length ? `\n\n${sections.join('\n\n')}` : '';
+};
+//# sourceMappingURL=utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../../src/handlers/tool-configs/universal/core/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EACL,kBAAkB,IAAI,uBAAuB,EAG7C,gBAAgB,IAAI,sBAAsB,EAC1C,YAAY,IAAI,kBAAkB,GACnC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,0BAA0B,EAC1B,0BAA0B,GAE3B,MAAM,oBAAoB,CAAC;AAE5B;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,YAAmC;IAEnC,QAAQ,YAAY,EAAE,CAAC;QACrB,KAAK,qBAAqB,CAAC,SAAS;YAClC,OAAO,WAAW,CAAC;QACrB,KAAK,qBAAqB,CAAC,MAAM;YAC/B,OAAO,QAAQ,CAAC;QAClB,KAAK,qBAAqB,CAAC,KAAK;YAC9B,OAAO,OAAO,CAAC;QACjB,KAAK,qBAAqB,CAAC,OAAO;YAChC,OAAO,SAAS,CAAC;QACnB,KAAK,qBAAqB,CAAC,KAAK;YAC9B,OAAO,OAAO,CAAC;QACjB,KAAK,qBAAqB,CAAC,KAAK;YAC9B,OAAO,OAAO,CAAC;QACjB,KAAK,qBAAqB,CAAC,KAAK;YAC9B,OAAO,OAAO,CAAC;QACjB;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC;AAED,yDAAyD;AACzD,uEAAuE;AACvE,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AAChD,MAAM,YAAY,GAAG,kBAAkB,CAAC;AAExC,4CAA4C;AAC5C,MAAM,CAAC,MAAM,kBAAkB,GAAG,uBAAuB,CAAC;AAQ1D,MAAM,iBAAiB,GAAG,CAAC,KAAc,EAAU,EAAE;IACnD,+BAA+B;IAC/B,OAAO,0BAA0B,CAAC,KAAK,CAAC,CAAC;AAC3C,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACrC,QAA6B,EACrB,EAAE;IACV,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAC;IAEzB,sCAAsC;IACtC,MAAM,iBAAiB,GAAG,0BAA0B,CAAC,QAAQ,CAAC,CAAC;IAC/D,IAAI,CAAC,iBAAiB;QAAE,OAAO,EAAE,CAAC;IAElC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,IAAI,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;QACvC,QAAQ,CAAC,IAAI,CACX;YACE,WAAW;YACX,GAAG,iBAAiB,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,OAAO,EAAE,CAAC;SAC/D,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;IACJ,CAAC;IAED,MAAM,iBAAiB,GAAG,iBAAiB,CAAC,WAAW,EAAE,MAAM,CAC7D,CAAC,UAAU,EAAE,EAAE,CACb,iBAAiB,CAAC,QAAQ;QACxB,CAAC,CAAC,CAAC,iBAAiB,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC;QAClD,CAAC,CAAC,IAAI,CACX,CAAC;IAEF,IAAI,iBAAiB,IAAI,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtD,QAAQ,CAAC,IAAI,CACX;YACE,cAAc;YACd,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,KAAK,UAAU,EAAE,CAAC;SAC5D,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;IACJ,CAAC;IAED,IACE,iBAAiB,CAAC,QAAQ,EAAE,MAAM;QAClC,iBAAiB,CAAC,YAAY;QAC9B,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC,EACtD,CAAC;QACD,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAC,GAAG,CACpE,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,GAAG,KAAK,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAC1D,CAAC;QACF,QAAQ,CAAC,IAAI,CAAC,CAAC,0BAA0B,EAAE,GAAG,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACzE,CAAC;IAED,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAC/D,CAAC,CAAC"}

package/dist/handlers/tool-configs/universal/core/value-extractors.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Type-Safe Value Extraction Utilities
+ *
+ * Replaces the generic coercion functions with properly typed interfaces
+ * and type guards to improve type safety and reduce any usage.
+ */
+import { UniversalResourceType } from '../types.js';
+/**
+ * Standard Attio field value structure
+ */
+export interface AttioFieldValue {
+    value?: string;
+    full_name?: string;
+    formatted?: string;
+    display_value?: string;
+}
+/**
+ * Extended field value that may contain additional metadata
+ */
+export interface ExtendedAttioFieldValue extends AttioFieldValue {
+    [key: string]: unknown;
+}
+/**
+ * Type guard to check if a value is an AttioFieldValue
+ */
+export declare const isAttioFieldValue: (value: unknown) => value is AttioFieldValue;
+/**
+ * Type guard to check if a value is an array of AttioFieldValue objects
+ */
+export declare const isAttioFieldValueArray: (value: unknown) => value is AttioFieldValue[];
+/**
+ * Type-safe extraction of display value from an AttioFieldValue object
+ */
+export declare const extractFromAttioFieldValue: (fieldValue: AttioFieldValue) => string | undefined;
+/**
+ * Type-safe extraction of display value from an array of AttioFieldValue objects
+ */
+export declare const extractFromAttioFieldValueArray: (fieldValueArray: AttioFieldValue[]) => string | undefined;
+/**
+ * Type-safe extraction that handles various value types
+ */
+export declare const extractDisplayValue: (value: unknown) => string | undefined;
+/**
+ * Extract display name with resource-type-specific field prioritization
+ */
+export declare const extractDisplayName: (values: Record<string, unknown> | undefined, resourceType?: UniversalResourceType) => string;
+/**
+ * Extract multiple display values (useful for validation metadata)
+ */
+export declare const extractMultipleDisplayValues: (values: Record<string, unknown> | undefined, fieldNames: string[]) => Record<string, string>;
+/**
+ * Legacy compatibility function
+ * @deprecated Use extractDisplayValue instead
+ */
+export declare const coerceScalar: (value: unknown) => string | undefined;
+/**
+ * Legacy compatibility function
+ * @deprecated Use extractFromAttioFieldValueArray instead
+ */
+export declare const coerceArrayValue: (value: unknown) => string | undefined;
+//# sourceMappingURL=value-extractors.d.ts.map

package/dist/handlers/tool-configs/universal/core/value-extractors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-extractors.d.ts","sourceRoot":"","sources":["../../../../../src/handlers/tool-configs/universal/core/value-extractors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,eAAe;IAC9D,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,eAS3D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,GACjC,OAAO,OAAO,KACb,KAAK,IAAI,eAAe,EAE1B,CAAC;AAYF;;GAEG;AACH,eAAO,MAAM,0BAA0B,GACrC,YAAY,eAAe,KAC1B,MAAM,GAAG,SAQX,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,+BAA+B,GAC1C,iBAAiB,eAAe,EAAE,KACjC,MAAM,GAAG,SAcX,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAAI,OAAO,OAAO,KAAG,MAAM,GAAG,SAsC7D,CAAC;AAoDF;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC3C,eAAe,qBAAqB,KACnC,MAwCF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,4BAA4B,GACvC,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC3C,YAAY,MAAM,EAAE,KACnB,MAAM,CAAC,MAAM,EAAE,MAAM,CAcvB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,OAAO,KAAG,MAAM,GAAG,SAEtD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,KAAG,MAAM,GAAG,SAG1D,CAAC"}

package/dist/handlers/tool-configs/universal/core/value-extractors.js

@@ -0,0 +1,212 @@
+/**
+ * Type-Safe Value Extraction Utilities
+ *
+ * Replaces the generic coercion functions with properly typed interfaces
+ * and type guards to improve type safety and reduce any usage.
+ */
+import { UniversalResourceType } from '../types.js';
+/**
+ * Type guard to check if a value is an AttioFieldValue
+ */
+export const isAttioFieldValue = (value) => {
+    if (!value || typeof value !== 'object')
+        return false;
+    const obj = value;
+    return (typeof obj.value === 'string' ||
+        typeof obj.full_name === 'string' ||
+        typeof obj.formatted === 'string' ||
+        typeof obj.display_value === 'string');
+};
+/**
+ * Type guard to check if a value is an array of AttioFieldValue objects
+ */
+export const isAttioFieldValueArray = (value) => {
+    return Array.isArray(value) && value.every(isAttioFieldValue);
+};
+/**
+ * Ordered keys to attempt when extracting display values
+ */
+const DISPLAY_VALUE_KEYS = [
+    'display_value',
+    'formatted',
+    'full_name',
+    'value',
+];
+/**
+ * Type-safe extraction of display value from an AttioFieldValue object
+ */
+export const extractFromAttioFieldValue = (fieldValue) => {
+    for (const key of DISPLAY_VALUE_KEYS) {
+        const value = fieldValue[key];
+        if (typeof value === 'string' && value.trim().length > 0) {
+            return value.trim();
+        }
+    }
+    return undefined;
+};
+/**
+ * Type-safe extraction of display value from an array of AttioFieldValue objects
+ */
+export const extractFromAttioFieldValueArray = (fieldValueArray) => {
+    if (fieldValueArray.length === 0)
+        return undefined;
+    // Try to extract from the first element
+    const firstValue = extractFromAttioFieldValue(fieldValueArray[0]);
+    if (firstValue)
+        return firstValue;
+    // If first element doesn't yield a value, try others
+    for (let i = 1; i < fieldValueArray.length; i++) {
+        const value = extractFromAttioFieldValue(fieldValueArray[i]);
+        if (value)
+            return value;
+    }
+    return undefined;
+};
+/**
+ * Type-safe extraction that handles various value types
+ */
+export const extractDisplayValue = (value) => {
+    // Handle null/undefined
+    if (value == null)
+        return undefined;
+    // Handle direct string values
+    if (typeof value === 'string') {
+        return value.trim().length > 0 ? value.trim() : undefined;
+    }
+    // Handle arrays of AttioFieldValue objects
+    if (isAttioFieldValueArray(value)) {
+        return extractFromAttioFieldValueArray(value);
+    }
+    // Handle single AttioFieldValue objects
+    if (isAttioFieldValue(value)) {
+        return extractFromAttioFieldValue(value);
+    }
+    // Handle arrays that might contain strings or objects
+    if (Array.isArray(value) && value.length > 0) {
+        const first = value[0];
+        if (typeof first === 'string') {
+            return first.trim().length > 0 ? first.trim() : undefined;
+        }
+        // Try to extract from first object-like element
+        return extractDisplayValue(first);
+    }
+    // Handle objects with a value property
+    if (typeof value === 'object') {
+        const obj = value;
+        if ('value' in obj) {
+            return extractDisplayValue(obj.value);
+        }
+    }
+    return undefined;
+};
+const RESOURCE_FIELD_PRIORITIES = {
+    [UniversalResourceType.PEOPLE]: {
+        primaryFields: ['name', 'full_name', 'display_name'],
+        secondaryFields: ['first_name', 'last_name', 'email_address'],
+        fallbackFields: ['title', 'company_name'],
+    },
+    [UniversalResourceType.COMPANIES]: {
+        primaryFields: ['name', 'company_name', 'display_name'],
+        secondaryFields: ['legal_name', 'trading_name'],
+        fallbackFields: ['domain', 'website'],
+    },
+    [UniversalResourceType.DEALS]: {
+        primaryFields: ['name', 'deal_name', 'title'],
+        secondaryFields: ['description'],
+        fallbackFields: ['stage', 'amount'],
+    },
+    [UniversalResourceType.TASKS]: {
+        primaryFields: ['title', 'name', 'content'],
+        secondaryFields: ['description', 'summary'],
+        fallbackFields: ['assignee', 'status'],
+    },
+    [UniversalResourceType.NOTES]: {
+        primaryFields: ['title', 'content', 'name'],
+        secondaryFields: ['summary', 'description'],
+        fallbackFields: ['author', 'created_at'],
+    },
+    [UniversalResourceType.LISTS]: {
+        primaryFields: ['name', 'title', 'list_name'],
+        secondaryFields: ['description'],
+        fallbackFields: ['type', 'status'],
+    },
+    [UniversalResourceType.RECORDS]: {
+        primaryFields: ['name', 'title'],
+        secondaryFields: ['description', 'content'],
+        fallbackFields: ['id', 'created_at'],
+    },
+};
+/**
+ * Extract display name with resource-type-specific field prioritization
+ */
+export const extractDisplayName = (values, resourceType) => {
+    if (!values || typeof values !== 'object')
+        return 'Unnamed';
+    const priority = resourceType
+        ? RESOURCE_FIELD_PRIORITIES[resourceType]
+        : RESOURCE_FIELD_PRIORITIES[UniversalResourceType.RECORDS];
+    // Try primary fields first
+    for (const fieldName of priority.primaryFields) {
+        const value = values[fieldName];
+        const extracted = extractDisplayValue(value);
+        if (extracted)
+            return extracted;
+    }
+    // Try secondary fields
+    for (const fieldName of priority.secondaryFields) {
+        const value = values[fieldName];
+        const extracted = extractDisplayValue(value);
+        if (extracted)
+            return extracted;
+    }
+    // Try fallback fields
+    for (const fieldName of priority.fallbackFields) {
+        const value = values[fieldName];
+        const extracted = extractDisplayValue(value);
+        if (extracted)
+            return extracted;
+    }
+    // Final fallback - try any string-like field
+    for (const [key, value] of Object.entries(values)) {
+        if (key.toLowerCase().includes('name') ||
+            key.toLowerCase().includes('title')) {
+            const extracted = extractDisplayValue(value);
+            if (extracted)
+                return extracted;
+        }
+    }
+    return 'Unnamed';
+};
+/**
+ * Extract multiple display values (useful for validation metadata)
+ */
+export const extractMultipleDisplayValues = (values, fieldNames) => {
+    const result = {};
+    if (!values || typeof values !== 'object')
+        return result;
+    for (const fieldName of fieldNames) {
+        const value = values[fieldName];
+        const extracted = extractDisplayValue(value);
+        if (extracted) {
+            result[fieldName] = extracted;
+        }
+    }
+    return result;
+};
+/**
+ * Legacy compatibility function
+ * @deprecated Use extractDisplayValue instead
+ */
+export const coerceScalar = (value) => {
+    return extractDisplayValue(value);
+};
+/**
+ * Legacy compatibility function
+ * @deprecated Use extractFromAttioFieldValueArray instead
+ */
+export const coerceArrayValue = (value) => {
+    if (!Array.isArray(value))
+        return undefined;
+    return extractDisplayValue(value);
+};
+//# sourceMappingURL=value-extractors.js.map

package/dist/handlers/tool-configs/universal/core/value-extractors.js.map

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