attio-mcp 1.3.6 → 1.4.1

package/dist/handlers/tool-configs/universal/core/error-enhancers/attribute-enhancer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attribute-enhancer.d.ts","sourceRoot":"","sources":["../../../../../../src/handlers/tool-configs/universal/core/error-enhancers/attribute-enhancer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAoB,MAAM,YAAY,CAAC;AAkIlE;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,aAevC,CAAC"}

package/dist/handlers/tool-configs/universal/core/error-enhancers/attribute-enhancer.js

@@ -0,0 +1,118 @@
+/**
+ * Attribute Not Found Error Enhancer
+ * Issue #1001 - Strategy Pattern for CRUD error handling
+ *
+ * Detects "Cannot find attribute with slug/ID" errors and provides
+ * suggestions using Levenshtein distance algorithm.
+ *
+ * CRITICAL: This enhancer caused PR #1048 to fail due to missing
+ * function signatures. All functions must have COMPLETE declarations.
+ */
+import { sanitizedLog } from '../pii-sanitizer.js';
+import { createScopedLogger } from '../../../../../utils/logger.js';
+const logger = createScopedLogger('attribute-enhancer');
+/**
+ * Calculate Levenshtein distance between two strings
+ * Used for suggesting similar attribute names
+ *
+ * PR #1048 FAILURE POINT: Must include COMPLETE function signature
+ * NOT: const matrix: number[][] = []
+ * BUT: const levenshteinDistance = (a: string, b: string): number => { const matrix... }
+ */
+const levenshteinDistance = (a, b) => {
+    const matrix = [];
+    // Initialize first column
+    for (let i = 0; i <= a.length; i++) {
+        matrix[i] = [i];
+    }
+    // Initialize first row
+    for (let j = 0; j <= b.length; j++) {
+        matrix[0][j] = j;
+    }
+    // Fill in the rest of the matrix
+    for (let i = 1; i <= a.length; i++) {
+        for (let j = 1; j <= b.length; j++) {
+            if (a[i - 1] === b[j - 1]) {
+                matrix[i][j] = matrix[i - 1][j - 1];
+            }
+            else {
+                matrix[i][j] = Math.min(matrix[i - 1][j - 1] + 1, // substitution
+                matrix[i][j - 1] + 1, // insertion
+                matrix[i - 1][j] + 1 // deletion
+                );
+            }
+        }
+    }
+    return matrix[a.length][b.length];
+};
+/**
+ * Find similar attribute names using Levenshtein distance
+ */
+const findSimilarAttributes = (target, candidates, maxResults) => {
+    const scored = candidates.map((c) => ({
+        name: c,
+        distance: levenshteinDistance(target.toLowerCase(), c.toLowerCase()),
+    }));
+    return scored
+        .filter((s) => s.distance <= 3) // Max 3 edits
+        .sort((a, b) => a.distance - b.distance)
+        .slice(0, maxResults)
+        .map((s) => s.name);
+};
+/**
+ * Enhance error messages for attribute-not-found errors
+ * Detects "Cannot find attribute with slug/ID" errors and provides suggestions
+ */
+const enhanceAttributeNotFoundError = async (error, resourceType) => {
+    const msg = error instanceof Error ? error.message : String(error);
+    // Pattern: "Cannot find attribute with slug/ID "X"."
+    const attrMatch = msg.match(/Cannot find attribute with slug\/ID "(.+?)"/);
+    if (!attrMatch)
+        return null;
+    const invalidAttr = attrMatch[1];
+    try {
+        // Fetch valid attributes and find similar ones
+        const { handleUniversalDiscoverAttributes } = await import('../../shared-handlers.js');
+        const schema = await handleUniversalDiscoverAttributes(resourceType);
+        const allAttrs = (schema.all || []);
+        const attrNames = allAttrs
+            .flatMap((a) => [a.name, a.title, a.api_slug])
+            .filter(Boolean);
+        // Find similar attribute names using Levenshtein distance
+        const suggestions = findSimilarAttributes(invalidAttr, attrNames, 3);
+        let message = `Attribute "${invalidAttr}" does not exist on ${resourceType}.\n\n`;
+        if (suggestions.length > 0) {
+            message += `Did you mean: ${suggestions.map((s) => `"${s}"`).join(', ')}?\n\n`;
+        }
+        message += `Next step: Call records_discover_attributes with\n`;
+        message += `  resource_type: "${resourceType}"\n`;
+        message += `to see all valid attributes.`;
+        return message;
+    }
+    catch (err) {
+        sanitizedLog(logger, 'debug', 'Failed to discover attributes for suggestions', {
+            enhancerName: 'attribute-not-found',
+            resourceType,
+            invalidAttribute: invalidAttr,
+            error: err instanceof Error ? err.message : String(err),
+        });
+        return (`Attribute "${invalidAttr}" does not exist on ${resourceType}.\n\n` +
+            `Next step: Use records_discover_attributes to see valid attributes.`);
+    }
+};
+/**
+ * Attribute Not Found Enhancer
+ * Uses Levenshtein distance to suggest similar attribute names
+ */
+export const attributeNotFoundEnhancer = {
+    name: 'attribute-not-found',
+    errorName: 'attribute_not_found',
+    matches: (error, _context) => {
+        const msg = error instanceof Error ? error.message : String(error);
+        return msg.includes('Cannot find attribute with slug/ID');
+    },
+    enhance: async (error, context) => {
+        return enhanceAttributeNotFoundError(error, context.resourceType);
+    },
+};
+//# sourceMappingURL=attribute-enhancer.js.map

package/dist/handlers/tool-configs/universal/core/error-enhancers/attribute-enhancer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attribute-enhancer.js","sourceRoot":"","sources":["../../../../../../src/handlers/tool-configs/universal/core/error-enhancers/attribute-enhancer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,MAAM,GAAG,kBAAkB,CAAC,oBAAoB,CAAC,CAAC;AAExD;;;;;;;GAOG;AACH,MAAM,mBAAmB,GAAG,CAAC,CAAS,EAAE,CAAS,EAAU,EAAE;IAC3D,MAAM,MAAM,GAAe,EAAE,CAAC;IAE9B,0BAA0B;IAC1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,uBAAuB;IACvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;IAED,iCAAiC;IACjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACnC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;gBAC1B,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACtC,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CACrB,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,eAAe;gBACzC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,YAAY;gBAClC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,WAAW;iBACjC,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AACpC,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,qBAAqB,GAAG,CAC5B,MAAc,EACd,UAAoB,EACpB,UAAkB,EACR,EAAE;IACZ,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACpC,IAAI,EAAE,CAAC;QACP,QAAQ,EAAE,mBAAmB,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;KACrE,CAAC,CAAC,CAAC;IACJ,OAAO,MAAM;SACV,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,cAAc;SAC7C,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC;SACvC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC;SACpB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,6BAA6B,GAAG,KAAK,EACzC,KAAc,EACd,YAAoB,EACI,EAAE;IAC1B,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAEnE,qDAAqD;IACrD,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;IAC3E,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAE5B,MAAM,WAAW,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;IAEjC,IAAI,CAAC;QACH,+CAA+C;QAC/C,MAAM,EAAE,iCAAiC,EAAE,GACzC,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;QAC3C,MAAM,MAAM,GAAG,MAAM,iCAAiC,CACpD,YAAqC,CACtC,CAAC;QACF,MAAM,QAAQ,GAAG,CAAE,MAAkC,CAAC,GAAG,IAAI,EAAE,CAI7D,CAAC;QACH,MAAM,SAAS,GAAG,QAAQ;aACvB,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC;aAC7C,MAAM,CAAC,OAAO,CAAa,CAAC;QAE/B,0DAA0D;QAC1D,MAAM,WAAW,GAAG,qBAAqB,CAAC,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;QAErE,IAAI,OAAO,GAAG,cAAc,WAAW,uBAAuB,YAAY,OAAO,CAAC;QAElF,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,OAAO,IAAI,iBAAiB,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;QACjF,CAAC;QAED,OAAO,IAAI,oDAAoD,CAAC;QAChE,OAAO,IAAI,qBAAqB,YAAY,KAAK,CAAC;QAClD,OAAO,IAAI,8BAA8B,CAAC;QAE1C,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,YAAY,CACV,MAAM,EACN,OAAO,EACP,+CAA+C,EAC/C;YACE,YAAY,EAAE,qBAAqB;YACnC,YAAY;YACZ,gBAAgB,EAAE,WAAW;YAC7B,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACxD,CACF,CAAC;QACF,OAAO,CACL,cAAc,WAAW,uBAAuB,YAAY,OAAO;YACnE,qEAAqE,CACtE,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAkB;IACtD,IAAI,EAAE,qBAAqB;IAC3B,SAAS,EAAE,qBAAqB;IAEhC,OAAO,EAAE,CAAC,KAAc,EAAE,QAA0B,EAAW,EAAE;QAC/D,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnE,OAAO,GAAG,CAAC,QAAQ,CAAC,oCAAoC,CAAC,CAAC;IAC5D,CAAC;IAED,OAAO,EAAE,KAAK,EACZ,KAAc,EACd,OAAyB,EACD,EAAE;QAC1B,OAAO,6BAA6B,CAAC,KAAK,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IACpE,CAAC;CACF,CAAC"}

package/dist/handlers/tool-configs/universal/core/error-enhancers/complex-type-enhancer.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Complex Type Error Enhancer
+ * Issue #1001 - Strategy Pattern for CRUD error handling
+ *
+ * Enhances errors for complex type fields: location, phone-number, personal-name
+ * Provides example structures and usage tips.
+ */
+import type { ErrorEnhancer } from './types.js';
+/**
+ * Complex Type Enhancer
+ * Handles location, phone-number, and personal-name field errors
+ */
+export declare const complexTypeEnhancer: ErrorEnhancer;
+//# sourceMappingURL=complex-type-enhancer.d.ts.map

package/dist/handlers/tool-configs/universal/core/error-enhancers/complex-type-enhancer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"complex-type-enhancer.d.ts","sourceRoot":"","sources":["../../../../../../src/handlers/tool-configs/universal/core/error-enhancers/complex-type-enhancer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAoB,MAAM,YAAY,CAAC;AAqFlE;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,aAoBjC,CAAC"}

package/dist/handlers/tool-configs/universal/core/error-enhancers/complex-type-enhancer.js

@@ -0,0 +1,77 @@
+/**
+ * Complex Type Error Enhancer
+ * Issue #1001 - Strategy Pattern for CRUD error handling
+ *
+ * Enhances errors for complex type fields: location, phone-number, personal-name
+ * Provides example structures and usage tips.
+ */
+import { getErrorMessage, isAxiosError } from './types.js';
+/**
+ * Enhance complex type errors (location, personal-name, phone-number)
+ */
+const enhanceComplexTypeError = (error, recordData) => {
+    const locationExample = '{\n' +
+        '  "line_1": "123 Main St",\n' +
+        '  "locality": "City",\n' +
+        '  "region": "State",\n' +
+        '  "postcode": "12345",\n' +
+        '  "country_code": "US",\n' +
+        '  "latitude": null,\n' +
+        '  "longitude": null,\n' +
+        '  "line_2": null,\n' +
+        '  "line_3": null,\n' +
+        '  "line_4": null\n' +
+        '}';
+    const phoneExample = '{ "phone_number": "+15551234567", "country_code": "US" }';
+    const nameExample = '{ "first_name": "Jane", "last_name": "Doe" }';
+    const msg = getErrorMessage(error);
+    const validationErrors = isAxiosError(error)
+        ? error.response?.data?.validation_errors
+        : null;
+    const recordFields = recordData ? Object.keys(recordData) : [];
+    const containsLocation = /location/i.test(msg) ||
+        recordFields.some((f) => /location/i.test(f)) ||
+        (validationErrors &&
+            validationErrors.some((ve) => /location/i.test(String(ve?.field || ve?.path || ve?.message || ''))));
+    if (containsLocation) {
+        return (`Invalid location value. Expected an object with all required fields.\n\n` +
+            `Expected structure:\n${locationExample}\n\n` +
+            `Tip: Missing fields are auto-filled with null; pass an object, not a string.`);
+    }
+    const containsPhone = /phone/.test(msg) ||
+        (validationErrors &&
+            validationErrors.some((ve) => /phone/.test(String(ve?.field || ve?.path || ve?.message || ''))));
+    if (containsPhone) {
+        return (`Invalid phone-number value. Provide phone_number or original_phone_number strings.\n\n` +
+            `Example: ${phoneExample}\n\n` +
+            `Tip: Strings are normalized to E.164; keep label/type fields if needed.`);
+    }
+    const containsPersonalName = /personal-name/.test(msg) ||
+        (validationErrors &&
+            validationErrors.some((ve) => /name/.test(String(ve?.field || ve?.path || ve?.message || ''))));
+    if (containsPersonalName) {
+        return (`Invalid personal-name value. Provide first_name/last_name or full_name.\n\n` +
+            `Example: ${nameExample}\n\n` +
+            `Tip: Strings are parsed automatically; empty strings are rejected.`);
+    }
+    return null;
+};
+/**
+ * Complex Type Enhancer
+ * Handles location, phone-number, and personal-name field errors
+ */
+export const complexTypeEnhancer = {
+    name: 'complex-type',
+    errorName: 'validation_error',
+    matches: (error, _context) => {
+        const msg = getErrorMessage(error);
+        return (/location/i.test(msg) ||
+            /phone/.test(msg) ||
+            /personal-name/.test(msg) ||
+            msg.includes('Invalid value'));
+    },
+    enhance: async (error, context) => {
+        return enhanceComplexTypeError(error, context.recordData);
+    },
+};
+//# sourceMappingURL=complex-type-enhancer.js.map

package/dist/handlers/tool-configs/universal/core/error-enhancers/complex-type-enhancer.js.map

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

package/dist/handlers/tool-configs/universal/core/error-enhancers/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Error Enhancers - Centralized Exports & Pipelines
+ * Issue #1001 - Strategy Pattern for CRUD error handling
+ */
+import { requiredFieldsEnhancer } from './required-fields-enhancer.js';
+import { uniquenessEnhancer } from './uniqueness-enhancer.js';
+import { attributeNotFoundEnhancer } from './attribute-enhancer.js';
+import { selectStatusEnhancer } from './select-status-enhancer.js';
+import { complexTypeEnhancer } from './complex-type-enhancer.js';
+import { recordReferenceEnhancer } from './record-reference-enhancer.js';
+/**
+ * Enhancer pipeline for CREATE operations
+ * Order matters: more specific errors before generic ones
+ */
+export declare const CREATE_ERROR_ENHANCERS: readonly [import("./types.js").ErrorEnhancer, import("./types.js").ErrorEnhancer, import("./types.js").ErrorEnhancer, import("./types.js").ErrorEnhancer, import("./types.js").ErrorEnhancer, import("./types.js").ErrorEnhancer];
+/**
+ * Enhancer pipeline for UPDATE operations
+ * Note: Required fields and uniqueness checks not needed for updates
+ */
+export declare const UPDATE_ERROR_ENHANCERS: readonly [import("./types.js").ErrorEnhancer, import("./types.js").ErrorEnhancer, import("./types.js").ErrorEnhancer, import("./types.js").ErrorEnhancer];
+export { requiredFieldsEnhancer, uniquenessEnhancer, attributeNotFoundEnhancer, selectStatusEnhancer, complexTypeEnhancer, recordReferenceEnhancer, };
+export type { CrudErrorContext, ErrorEnhancer, ValidationMetadata, AxiosError, AxiosErrorResponse, } from './types.js';
+export { isAxiosError } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/handlers/tool-configs/universal/core/error-enhancers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/handlers/tool-configs/universal/core/error-enhancers/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAEzE;;;GAGG;AACH,eAAO,MAAM,sBAAsB,mOAOzB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,sBAAsB,2JAKzB,CAAC;AAEX,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,yBAAyB,EACzB,oBAAoB,EACpB,mBAAmB,EACnB,uBAAuB,GACxB,CAAC;AAEF,YAAY,EACV,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,UAAU,EACV,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/handlers/tool-configs/universal/core/error-enhancers/index.js

@@ -0,0 +1,35 @@
+/**
+ * Error Enhancers - Centralized Exports & Pipelines
+ * Issue #1001 - Strategy Pattern for CRUD error handling
+ */
+import { requiredFieldsEnhancer } from './required-fields-enhancer.js';
+import { uniquenessEnhancer } from './uniqueness-enhancer.js';
+import { attributeNotFoundEnhancer } from './attribute-enhancer.js';
+import { selectStatusEnhancer } from './select-status-enhancer.js';
+import { complexTypeEnhancer } from './complex-type-enhancer.js';
+import { recordReferenceEnhancer } from './record-reference-enhancer.js';
+/**
+ * Enhancer pipeline for CREATE operations
+ * Order matters: more specific errors before generic ones
+ */
+export const CREATE_ERROR_ENHANCERS = [
+    requiredFieldsEnhancer,
+    uniquenessEnhancer,
+    attributeNotFoundEnhancer,
+    complexTypeEnhancer,
+    selectStatusEnhancer,
+    recordReferenceEnhancer,
+];
+/**
+ * Enhancer pipeline for UPDATE operations
+ * Note: Required fields and uniqueness checks not needed for updates
+ */
+export const UPDATE_ERROR_ENHANCERS = [
+    attributeNotFoundEnhancer,
+    complexTypeEnhancer,
+    selectStatusEnhancer,
+    recordReferenceEnhancer,
+];
+export { requiredFieldsEnhancer, uniquenessEnhancer, attributeNotFoundEnhancer, selectStatusEnhancer, complexTypeEnhancer, recordReferenceEnhancer, };
+export { isAxiosError } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/handlers/tool-configs/universal/core/error-enhancers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/handlers/tool-configs/universal/core/error-enhancers/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAEzE;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,sBAAsB;IACtB,kBAAkB;IAClB,yBAAyB;IACzB,mBAAmB;IACnB,oBAAoB;IACpB,uBAAuB;CACf,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,yBAAyB;IACzB,mBAAmB;IACnB,oBAAoB;IACpB,uBAAuB;CACf,CAAC;AAEX,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,yBAAyB,EACzB,oBAAoB,EACpB,mBAAmB,EACnB,uBAAuB,GACxB,CAAC;AAUF,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/handlers/tool-configs/universal/core/error-enhancers/record-reference-enhancer.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Record Reference Error Enhancer
+ * Issue #1001 - Strategy Pattern for CRUD error handling
+ * Issue #997 - Enhanced record-reference attribute error handling
+ *
+ * Detects "Missing target_object on record reference value" and similar errors
+ * Provides format guidance for record-reference fields.
+ */
+import type { ErrorEnhancer } from './types.js';
+/**
+ * Record Reference Enhancer
+ * Handles record-reference field format errors (Issue #997)
+ */
+export declare const recordReferenceEnhancer: ErrorEnhancer;
+//# sourceMappingURL=record-reference-enhancer.d.ts.map

package/dist/handlers/tool-configs/universal/core/error-enhancers/record-reference-enhancer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-reference-enhancer.d.ts","sourceRoot":"","sources":["../../../../../../src/handlers/tool-configs/universal/core/error-enhancers/record-reference-enhancer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAoB,MAAM,YAAY,CAAC;AA8ElE;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,aAyCrC,CAAC"}

package/dist/handlers/tool-configs/universal/core/error-enhancers/record-reference-enhancer.js

@@ -0,0 +1,108 @@
+/**
+ * Record Reference Error Enhancer
+ * Issue #1001 - Strategy Pattern for CRUD error handling
+ * Issue #997 - Enhanced record-reference attribute error handling
+ *
+ * Detects "Missing target_object on record reference value" and similar errors
+ * Provides format guidance for record-reference fields.
+ */
+import { getErrorMessage, isAxiosError } from './types.js';
+/**
+ * Enhance error messages for record-reference attribute errors
+ */
+const enhanceRecordReferenceError = (error, recordData) => {
+    const msg = getErrorMessage(error);
+    // Also check for validation_errors in axios response
+    let fullErrorText = msg;
+    if (isAxiosError(error)) {
+        const data = error.response?.data;
+        if (data?.message) {
+            fullErrorText += ' ' + data.message;
+        }
+        if (data?.validation_errors) {
+            fullErrorText +=
+                ' ' +
+                    data.validation_errors.map((e) => String(e.message || e)).join(' ');
+        }
+    }
+    // Pattern detection for record-reference errors
+    const isRecordRefError = fullErrorText.includes('Missing target_object') ||
+        fullErrorText.includes('record reference') ||
+        fullErrorText.includes('target_record_id') ||
+        (fullErrorText.includes('Invalid value was passed to attribute') &&
+            (fullErrorText.includes('company') ||
+                fullErrorText.includes('associated_people') ||
+                fullErrorText.includes('associated_company') ||
+                fullErrorText.includes('main_contact')));
+    if (!isRecordRefError)
+        return null;
+    // Try to identify which field might be the issue
+    const potentialRefFields = [
+        'company',
+        'associated_company',
+        'associated_people',
+        'main_contact',
+        'person',
+        'people',
+    ];
+    let affectedField = null;
+    if (recordData) {
+        for (const field of potentialRefFields) {
+            if (field in recordData) {
+                affectedField = field;
+                break;
+            }
+        }
+    }
+    let message = `Record reference format error`;
+    if (affectedField) {
+        message += ` on field "${affectedField}"`;
+    }
+    message += `.\n\n`;
+    message += `The Attio API expects record-reference fields in this format:\n`;
+    message += `  [{ "target_object": "object_type", "target_record_id": "uuid" }]\n\n`;
+    message += `Simplified formats (auto-transformed by this server):\n`;
+    message += `  • String: "company": "record-uuid"\n`;
+    message += `  • Legacy object: "company": {"record_id": "uuid"}\n\n`;
+    message += `If you're seeing this error, the auto-transformation may have failed.\n`;
+    message += `Ensure the record ID is valid and the field name is correct.`;
+    return message;
+};
+/**
+ * Record Reference Enhancer
+ * Handles record-reference field format errors (Issue #997)
+ */
+export const recordReferenceEnhancer = {
+    name: 'record-reference',
+    errorName: 'record_reference_error',
+    matches: (error, _context) => {
+        const msg = getErrorMessage(error);
+        // Check for axios validation errors
+        let fullText = msg;
+        if (isAxiosError(error)) {
+            const data = error.response?.data;
+            if (data?.message) {
+                fullText += ' ' + data.message;
+            }
+            // CRITICAL: Also check validation_errors array for record-reference patterns
+            if (data?.validation_errors) {
+                fullText +=
+                    ' ' +
+                        data.validation_errors.map((e) => String(e.message || e)).join(' ');
+            }
+        }
+        return (fullText.includes('Missing target_object') ||
+            fullText.includes('record reference') ||
+            fullText.includes('target_record_id') ||
+            // CRITICAL: Match "Invalid value was passed to attribute" pattern (from enhanceRecordReferenceError)
+            (fullText.includes('Invalid value was passed to attribute') &&
+                (fullText.includes('company') ||
+                    fullText.includes('associated_people') ||
+                    fullText.includes('associated_company') ||
+                    fullText.includes('main_contact'))));
+    },
+    enhance: async (error, context) => {
+        return enhanceRecordReferenceError(error, context.recordData);
+    },
+};
+//# sourceMappingURL=record-reference-enhancer.js.map

package/dist/handlers/tool-configs/universal/core/error-enhancers/record-reference-enhancer.js.map

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

package/dist/handlers/tool-configs/universal/core/error-enhancers/required-fields-enhancer.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Required Fields Error Enhancer
+ * Issue #1001 - Strategy Pattern for CRUD error handling
+ *
+ * Detects missing required fields and provides specific guidance,
+ * especially for deal-specific required fields like "stage".
+ */
+import type { ErrorEnhancer } from './types.js';
+/**
+ * Required Fields Enhancer
+ * Detects missing required field errors and provides context-specific guidance
+ */
+export declare const requiredFieldsEnhancer: ErrorEnhancer;
+//# sourceMappingURL=required-fields-enhancer.d.ts.map

package/dist/handlers/tool-configs/universal/core/error-enhancers/required-fields-enhancer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"required-fields-enhancer.d.ts","sourceRoot":"","sources":["../../../../../../src/handlers/tool-configs/universal/core/error-enhancers/required-fields-enhancer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAoB,MAAM,YAAY,CAAC;AAuFlE;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,aA0BpC,CAAC"}

package/dist/handlers/tool-configs/universal/core/error-enhancers/required-fields-enhancer.js

@@ -0,0 +1,91 @@
+/**
+ * Required Fields Error Enhancer
+ * Issue #1001 - Strategy Pattern for CRUD error handling
+ *
+ * Detects missing required fields and provides specific guidance,
+ * especially for deal-specific required fields like "stage".
+ */
+import { UniversalResourceType } from '../../../../../handlers/tool-configs/universal/types.js';
+import { sanitizedLog } from '../pii-sanitizer.js';
+import { createScopedLogger } from '../../../../../utils/logger.js';
+const logger = createScopedLogger('required-fields-enhancer');
+/**
+ * Normalize field names for comparison
+ */
+const normalizeFieldName = (field) => field.trim().toLowerCase();
+/**
+ * Check if recordData contains a stage field (for deals)
+ */
+const hasStageField = (recordData) => {
+    const directKeys = Object.keys(recordData).map(normalizeFieldName);
+    if (directKeys.includes('stage') ||
+        directKeys.includes('deal stage') ||
+        directKeys.includes('status')) {
+        return true;
+    }
+    const values = recordData.values &&
+        typeof recordData.values === 'object' &&
+        recordData.values !== null
+        ? recordData.values
+        : null;
+    if (!values)
+        return false;
+    const valueKeys = Object.keys(values).map(normalizeFieldName);
+    return (valueKeys.includes('stage') ||
+        valueKeys.includes('deal stage') ||
+        valueKeys.includes('status'));
+};
+/**
+ * Build enhanced error message for missing deal stage
+ */
+const buildMissingDealStageMessage = async (recordData) => {
+    if (hasStageField(recordData))
+        return null;
+    try {
+        const { AttributeOptionsService } = await import('../../../../../services/metadata/index.js');
+        const { options } = await AttributeOptionsService.getOptions('deals', 'stage');
+        const preview = options
+            .slice(0, 5)
+            .map((option) => `"${option.title}"`)
+            .join(', ');
+        const hasMore = options.length > 5 ? ` (+${options.length - 5} more)` : '';
+        return (`Required field "stage" is missing for deals.\n\n` +
+            `Common stage values: ${preview}${hasMore}\n\n` +
+            `For the full list, call: records_get_attribute_options(resource_type="deals", attribute="stage").`);
+    }
+    catch (err) {
+        sanitizedLog(logger, 'debug', 'Failed to fetch stage options for enhanced error message', {
+            enhancerName: 'required-fields',
+            resourceType: 'deals',
+            attribute: 'stage',
+            error: err instanceof Error ? err.message : String(err),
+        });
+        return (`Required field "stage" is missing for deals.\n\n` +
+            `Call records_get_attribute_options(resource_type="deals", attribute="stage") to retrieve valid stage values, then retry.`);
+    }
+};
+/**
+ * Required Fields Enhancer
+ * Detects missing required field errors and provides context-specific guidance
+ */
+export const requiredFieldsEnhancer = {
+    name: 'required-fields',
+    errorName: 'validation_error',
+    matches: (error, _context) => {
+        const msg = error instanceof Error ? error.message : String(error);
+        return msg.includes('required field') || msg.includes('Missing required');
+    },
+    enhance: async (_error, context) => {
+        const { resourceType, recordData } = context;
+        // Deal-specific required field handling
+        if (resourceType === UniversalResourceType.DEALS && recordData) {
+            const stageMessage = await buildMissingDealStageMessage(recordData);
+            if (stageMessage) {
+                return stageMessage;
+            }
+        }
+        // Generic required field message
+        return 'Missing required fields. Please check that all mandatory fields are provided.';
+    },
+};
+//# sourceMappingURL=required-fields-enhancer.js.map

package/dist/handlers/tool-configs/universal/core/error-enhancers/required-fields-enhancer.js.map

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

package/dist/handlers/tool-configs/universal/core/error-enhancers/select-status-enhancer.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Select/Status Error Enhancer
+ * Issue #1001 - Strategy Pattern for CRUD error handling
+ *
+ * Detects "Cannot find select option" or "Cannot find Status" errors
+ * and provides valid options from AttributeOptionsService.
+ */
+import type { ErrorEnhancer } from './types.js';
+/**
+ * Select/Status Enhancer
+ * Provides valid options for select and status field errors
+ */
+export declare const selectStatusEnhancer: ErrorEnhancer;
+//# sourceMappingURL=select-status-enhancer.d.ts.map

package/dist/handlers/tool-configs/universal/core/error-enhancers/select-status-enhancer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select-status-enhancer.d.ts","sourceRoot":"","sources":["../../../../../../src/handlers/tool-configs/universal/core/error-enhancers/select-status-enhancer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAoB,MAAM,YAAY,CAAC;AAmIlE;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,aAqBlC,CAAC"}