attio-mcp 0.1.1 → 1.0.0

package/dist/services/OpenAiCompatibilityService.js

@@ -0,0 +1,171 @@
+/**
+ * OpenAI compatibility helpers – expose the universal search + retrieval stack
+ * using the `search`/`fetch` contract that non-Developer-Mode ChatGPT accounts
+ * expect. All logic delegates to the existing universal services so we keep a
+ * single behaviour surface for every client.
+ */
+import { UniversalSearchService } from './UniversalSearchService.js';
+import { UniversalRetrievalService } from './UniversalRetrievalService.js';
+import { UniversalResourceType, SearchType, MatchType, SortType, } from '../handlers/tool-configs/universal/types.js';
+import { SearchUtilities } from './search-utilities/SearchUtilities.js';
+import { safeJsonStringify } from '../utils/json-serializer.js';
+const DEFAULT_LIMIT = 10;
+const MAX_LIMIT = 25;
+const RESOURCE_API_PATH = {
+    [UniversalResourceType.COMPANIES]: 'objects/companies/records',
+    [UniversalResourceType.PEOPLE]: 'objects/people/records',
+    [UniversalResourceType.LISTS]: 'lists',
+    [UniversalResourceType.TASKS]: 'tasks',
+};
+const SEARCH_RESOURCE_MAP = {
+    companies: [UniversalResourceType.COMPANIES],
+    people: [UniversalResourceType.PEOPLE],
+    lists: [UniversalResourceType.LISTS],
+    tasks: [UniversalResourceType.TASKS],
+    all: [
+        UniversalResourceType.COMPANIES,
+        UniversalResourceType.PEOPLE,
+        UniversalResourceType.LISTS,
+        UniversalResourceType.TASKS,
+    ],
+};
+export class OpenAiCompatibilityService {
+    static async search(params) {
+        const query = params.query?.trim();
+        if (!query) {
+            throw new Error('Query must be provided');
+        }
+        const typeKey = (params.type ?? 'all').toLowerCase();
+        const resourceTypes = SEARCH_RESOURCE_MAP[typeKey] ?? SEARCH_RESOURCE_MAP.all;
+        const requestedLimit = params.limit ?? DEFAULT_LIMIT;
+        const limit = Math.min(Math.max(requestedLimit, 1), MAX_LIMIT);
+        const perTypeLimit = Math.max(1, Math.ceil(limit / resourceTypes.length));
+        const aggregated = [];
+        for (const resourceType of resourceTypes) {
+            const searchParams = {
+                resource_type: resourceType,
+                query,
+                limit: perTypeLimit,
+                search_type: SearchType.BASIC,
+                match_type: MatchType.PARTIAL,
+                sort: SortType.RELEVANCE,
+            };
+            const records = await UniversalSearchService.searchRecords(searchParams);
+            aggregated.push(...records.map((record) => transformRecordToSearchResult(resourceType, record)));
+        }
+        return aggregated.slice(0, limit);
+    }
+    static async fetch(id) {
+        const { resourceType, recordId } = parseCompoundId(id);
+        const record = await UniversalRetrievalService.getRecordDetails({
+            resource_type: resourceType,
+            record_id: recordId,
+        });
+        return transformRecordToFetchResult(resourceType, record);
+    }
+}
+function parseCompoundId(id) {
+    if (!id || !id.includes(':')) {
+        throw new Error('Expected identifier format "<resource_type>:<record_id>" (e.g. companies:1234)');
+    }
+    const [rawType, ...rest] = id.split(':');
+    const recordId = rest.join(':');
+    if (!recordId) {
+        throw new Error('Record identifier is missing');
+    }
+    const resourceType = normalizeResourceType(rawType);
+    return { resourceType, recordId };
+}
+function normalizeResourceType(value) {
+    switch (value.toLowerCase()) {
+        case 'companies':
+            return UniversalResourceType.COMPANIES;
+        case 'people':
+            return UniversalResourceType.PEOPLE;
+        case 'lists':
+            return UniversalResourceType.LISTS;
+        case 'tasks':
+            return UniversalResourceType.TASKS;
+        default:
+            throw new Error(`Unsupported resource type: ${value}`);
+    }
+}
+function transformRecordToSearchResult(resourceType, record) {
+    const recordId = record.id?.record_id ?? 'unknown';
+    return {
+        id: `${resourceType}:${recordId}`,
+        title: buildTitle(resourceType, record),
+        url: buildApiUrl(resourceType, recordId),
+        snippet: buildSnippet(resourceType, record),
+        metadata: {
+            resource_type: resourceType,
+        },
+    };
+}
+function transformRecordToFetchResult(resourceType, record) {
+    const recordId = record.id?.record_id ?? 'unknown';
+    return {
+        id: `${resourceType}:${recordId}`,
+        title: buildTitle(resourceType, record),
+        url: buildApiUrl(resourceType, recordId),
+        text: safeJsonStringify(record, { indent: 2 }),
+        metadata: {
+            resource_type: resourceType,
+        },
+    };
+}
+function buildTitle(resourceType, record) {
+    switch (resourceType) {
+        case UniversalResourceType.COMPANIES:
+            return (SearchUtilities.getFieldValue(record, 'name') ||
+                SearchUtilities.getFieldValue(record, 'legal_name') ||
+                `Company ${record.id?.record_id ?? ''}`.trim());
+        case UniversalResourceType.PEOPLE:
+            return (SearchUtilities.getFieldValue(record, 'name') ||
+                SearchUtilities.getFieldValue(record, 'full_name') ||
+                `Person ${record.id?.record_id ?? ''}`.trim());
+        case UniversalResourceType.LISTS:
+            return (SearchUtilities.getFieldValue(record, 'name') ||
+                `List ${record.id?.record_id ?? ''}`.trim());
+        case UniversalResourceType.TASKS:
+            return (SearchUtilities.getFieldValue(record, 'content') ||
+                SearchUtilities.getFieldValue(record, 'title') ||
+                `Task ${record.id?.record_id ?? ''}`.trim());
+        default:
+            return `Record ${record.id?.record_id ?? ''}`.trim();
+    }
+}
+function buildSnippet(resourceType, record) {
+    if (resourceType === UniversalResourceType.COMPANIES) {
+        return firstNonEmpty([
+            SearchUtilities.getFieldValue(record, 'description'),
+            SearchUtilities.getFieldValue(record, 'about'),
+            SearchUtilities.getFieldValue(record, 'industry'),
+        ]);
+    }
+    if (resourceType === UniversalResourceType.PEOPLE) {
+        return firstNonEmpty([
+            SearchUtilities.getFieldValue(record, 'job_title'),
+            SearchUtilities.getFieldValue(record, 'role'),
+            SearchUtilities.getFieldValue(record, 'headline'),
+        ]);
+    }
+    if (resourceType === UniversalResourceType.TASKS) {
+        return firstNonEmpty([
+            SearchUtilities.getFieldValue(record, 'status'),
+            SearchUtilities.getFieldValue(record, 'due_date'),
+        ]);
+    }
+    return undefined;
+}
+function firstNonEmpty(values) {
+    return values.find((value) => value && value.trim().length > 0);
+}
+function buildApiUrl(resourceType, recordId) {
+    const path = RESOURCE_API_PATH[resourceType];
+    if (!path) {
+        return `https://api.attio.com/v2/${recordId}`;
+    }
+    return `https://api.attio.com/v2/${path}/${recordId}`;
+}
+//# sourceMappingURL=OpenAiCompatibilityService.js.map

package/dist/services/OpenAiCompatibilityService.js.map

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

package/dist/services/UniversalCreateService.d.ts

@@ -0,0 +1,57 @@
+/**
+ * UniversalCreateService - Centralized record creation operations
+ *
+ * Extracted from shared-handlers.ts as part of Issue #489 Phase 3.
+ * Provides universal create functionality across all resource types with enhanced validation and error handling.
+ */
+import type { UniversalCreateParams } from '../handlers/tool-configs/universal/types.js';
+import { AttioRecord } from '../types/attio.js';
+/**
+ * Helper function to check if we should use mock data based on environment
+ */
+/**
+ * UniversalCreateService provides centralized record creation functionality
+ */
+export declare class UniversalCreateService {
+    /**
+     * Universal record creation with comprehensive field validation, mapping, and type safety
+     *
+     * This is the main entry point for creating records of any type in the Attio MCP Server.
+     * It provides a unified interface that handles field mapping, validation, type conversion,
+     * and error handling across all resource types.
+     *
+     * ## Features:
+     * - **Field Mapping**: Automatically maps common field name variations to Attio schema
+     * - **Attribute Discovery**: Fetches live schema information with caching for validation
+     * - **Type Safety**: Validates and converts field types to match Attio expectations
+     * - **Collision Detection**: Prevents multiple fields from mapping to the same target
+     * - **Enhanced Errors**: Provides detailed, actionable error messages with suggestions
+     * - **Performance Tracking**: Records metrics for monitoring and optimization
+     *
+     * @param params - The record creation parameters
+     * @param params.resource_type - Type of record to create (companies, people, etc.)
+     * @param params.record_data - The data for the new record
+     * @returns Promise resolving to the created AttioRecord with full metadata
+     *
+     * @throws {UniversalValidationError} When field validation fails with enhanced details
+     * @throws {Error} For authentication, network, or other system errors
+     *
+     * @example Basic company creation:
+     * ```typescript
+     * const company = await UniversalCreateService.createRecord({
+     *   resource_type: UniversalResourceType.COMPANIES,
+     *   record_data: {
+     *     name: "Acme Corporation",
+     *     domains: ["acme.com"],
+     *     description: "A software company"
+     *   }
+     * });
+     * ```
+     */
+    static createRecord(params: UniversalCreateParams): Promise<AttioRecord>;
+    /**
+     * Handle unsupported resource types with correction attempts
+     */
+    private static handleUnsupportedResourceType;
+}
+//# sourceMappingURL=UniversalCreateService.d.ts.map

package/dist/services/UniversalCreateService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UniversalCreateService.d.ts","sourceRoot":"","sources":["../../src/services/UniversalCreateService.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6CAA6C,CAAC;AACzF,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AA+DhD;;GAEG;AAMH;;GAEG;AACH,qBAAa,sBAAsB;IACjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;WACU,YAAY,CACvB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,WAAW,CAAC;IAmWvB;;OAEG;mBACkB,6BAA6B;CA2BnD"}

package/dist/services/UniversalCreateService.js

@@ -0,0 +1,358 @@
+/**
+ * UniversalCreateService - Centralized record creation operations
+ *
+ * Extracted from shared-handlers.ts as part of Issue #489 Phase 3.
+ * Provides universal create functionality across all resource types with enhanced validation and error handling.
+ */
+import { UniversalResourceType } from '../handlers/tool-configs/universal/types.js';
+import { UniversalValidationError, ErrorType, } from '../handlers/tool-configs/universal/schemas.js';
+// Import services
+import { ValidationService } from './ValidationService.js';
+// Import field mapping utilities
+import { mapRecordFields, validateResourceType, validateFields, getValidResourceTypes, FIELD_MAPPINGS, } from '../handlers/tool-configs/universal/field-mapper.js';
+// Import validation utilities
+import { validateRecordFields } from '../utils/validation-utils.js';
+// Import format helpers
+// Attribute format conversions are handled within create strategies
+// (Deal defaults are handled within the DealCreateStrategy)
+// Import people normalization utilities
+// People normalization handled in PersonCreateStrategy
+// Import enhanced error handling
+// Enhanced API error helpers are used within strategies
+// Import logging utilities
+import { OperationType, createScopedLogger } from '../utils/logger.js';
+// Import constants for better maintainability
+import { ERROR_MESSAGES, MAX_VALIDATION_SUGGESTIONS, MAX_SUGGESTION_TEXT_LENGTH, } from '../constants/universal.constants.js';
+// Import enhanced types for better type safety
+//
+import { createEnhancedValidationError, createFieldCollisionError, } from './create/helpers/ErrorHelpers.js';
+import { ErrorCategory } from './create/helpers/ErrorHelpers.js';
+// Create scoped logger for this service
+const logger = createScopedLogger('UniversalCreateService', undefined, OperationType.TOOL_EXECUTION);
+// Error helper utilities moved to ./create/helpers/ErrorHelpers
+// Field allowlists moved to strategies when needed
+// Resource-specific create functions are delegated to per-resource strategies
+/**
+ * Helper function to check if we should use mock data based on environment
+ */
+// Uniqueness error enhancement handled in strategies
+// Person field picking handled within PersonCreateStrategy
+/**
+ * UniversalCreateService provides centralized record creation functionality
+ */
+export class UniversalCreateService {
+    /**
+     * Universal record creation with comprehensive field validation, mapping, and type safety
+     *
+     * This is the main entry point for creating records of any type in the Attio MCP Server.
+     * It provides a unified interface that handles field mapping, validation, type conversion,
+     * and error handling across all resource types.
+     *
+     * ## Features:
+     * - **Field Mapping**: Automatically maps common field name variations to Attio schema
+     * - **Attribute Discovery**: Fetches live schema information with caching for validation
+     * - **Type Safety**: Validates and converts field types to match Attio expectations
+     * - **Collision Detection**: Prevents multiple fields from mapping to the same target
+     * - **Enhanced Errors**: Provides detailed, actionable error messages with suggestions
+     * - **Performance Tracking**: Records metrics for monitoring and optimization
+     *
+     * @param params - The record creation parameters
+     * @param params.resource_type - Type of record to create (companies, people, etc.)
+     * @param params.record_data - The data for the new record
+     * @returns Promise resolving to the created AttioRecord with full metadata
+     *
+     * @throws {UniversalValidationError} When field validation fails with enhanced details
+     * @throws {Error} For authentication, network, or other system errors
+     *
+     * @example Basic company creation:
+     * ```typescript
+     * const company = await UniversalCreateService.createRecord({
+     *   resource_type: UniversalResourceType.COMPANIES,
+     *   record_data: {
+     *     name: "Acme Corporation",
+     *     domains: ["acme.com"],
+     *     description: "A software company"
+     *   }
+     * });
+     * ```
+     */
+    static async createRecord(params) {
+        // CRITICAL FIX: Ensure record_data is always a plain object (not JSON string)
+        // Must mutate the original params.record_data, not just local variable
+        if (typeof params.record_data === 'string') {
+            try {
+                params.record_data = JSON.parse(params.record_data);
+            }
+            catch {
+                throw new UniversalValidationError('record_data must be an object');
+            }
+        }
+        const { resource_type } = params;
+        const record_data = params.record_data; // Use the potentially parsed record_data
+        if (!record_data ||
+            typeof record_data !== 'object' ||
+            Array.isArray(record_data)) {
+            throw new UniversalValidationError('record_data must be a JSON object');
+        }
+        logger.debug('Entry point - createRecord', {
+            resource_type,
+            record_data: JSON.stringify(record_data, null, 2),
+        });
+        // Pre-validate fields and provide helpful suggestions
+        // For records, only validate top-level fields (don't validate inside values)
+        let fieldsToValidate;
+        if (resource_type === UniversalResourceType.RECORDS) {
+            // Only validate top-level keys for records (exclude inner values)
+            const { values, ...topLevelFields } = record_data;
+            fieldsToValidate =
+                Object.keys(topLevelFields).length > 0
+                    ? topLevelFields
+                    : { object: 'placeholder' }; // Ensure non-empty object for validation
+            logger.debug('Records validation: checking only top-level fields', {
+                topLevelKeys: Object.keys(topLevelFields),
+                excludedValuesKeys: values
+                    ? Object.keys(values)
+                    : [],
+            });
+        }
+        else {
+            fieldsToValidate = (record_data.values || record_data); // Normal validation for other types
+        }
+        const fieldValidation = validateFields(resource_type, fieldsToValidate);
+        logger.debug('Field validation result', {
+            valid: fieldValidation.valid,
+            warnings: fieldValidation.warnings,
+            errors: fieldValidation.errors,
+            suggestions: fieldValidation.suggestions,
+        });
+        if (fieldValidation.warnings.length > 0) {
+            logger.warn('Field validation warnings', {
+                warnings: fieldValidation.warnings,
+            });
+        }
+        if (fieldValidation.suggestions.length > 0) {
+            const truncated = ValidationService.truncateSuggestions(fieldValidation.suggestions);
+            logger.info('Field suggestions available', {
+                suggestions: truncated,
+            });
+        }
+        if (!fieldValidation.valid) {
+            // Build a clear, helpful error message
+            let errorMessage = ERROR_MESSAGES.VALIDATION_FAILED(resource_type);
+            let remediation = [];
+            // Add each error on its own line for clarity
+            if (fieldValidation.errors.length > 0) {
+                errorMessage +=
+                    '\n' + fieldValidation.errors.map((err) => `  ❌ ${err}`).join('\n');
+            }
+            // Add suggestions if available (truncated to prevent buffer overflow)
+            if (fieldValidation.suggestions.length > 0) {
+                const truncated = ValidationService.truncateSuggestions(fieldValidation.suggestions);
+                errorMessage += '\n\n💡 Suggestions:\n';
+                errorMessage += truncated.map((sug) => `  • ${sug}`).join('\n');
+                remediation = truncated.slice(0, MAX_VALIDATION_SUGGESTIONS);
+            }
+            // List available fields for this resource type
+            const mapping = FIELD_MAPPINGS[resource_type];
+            if (mapping && mapping.validFields.length > 0) {
+                errorMessage += `\n\n📋 Available fields for ${resource_type}:\n  ${mapping.validFields.join(', ')}`;
+                remediation.push(`Use valid fields: ${mapping.validFields.slice(0, 5).join(', ')}`);
+            }
+            throw createEnhancedValidationError(errorMessage, {
+                field: 'record_data',
+                errorCode: 'FIELD_VALIDATION_FAILED',
+                suggestion: ValidationService.truncateSuggestions(fieldValidation.suggestions)
+                    .join('. ')
+                    .substring(0, MAX_SUGGESTION_TEXT_LENGTH),
+                remediation,
+            });
+        }
+        // Fetch available attributes for attribute-aware mapping (both api_slug and title)
+        // Skip attribute discovery for notes (they don't have /objects/notes/attributes endpoint)
+        let availableAttributes;
+        if (resource_type === UniversalResourceType.NOTES) {
+            logger.debug('Skipping attribute discovery for notes', {
+                reason: 'Notes are not under /objects/ and do not have attributes endpoint',
+            });
+            availableAttributes = undefined;
+        }
+        else {
+            try {
+                const { UniversalMetadataService } = await import('./UniversalMetadataService.js');
+                // For records, we need to extract the objectSlug for metadata discovery
+                const options = {};
+                if (resource_type === UniversalResourceType.RECORDS) {
+                    const objectSlug = record_data.object || record_data.object_api_slug;
+                    if (objectSlug && typeof objectSlug === 'string') {
+                        options.objectSlug = objectSlug;
+                    }
+                }
+                const attributeResult = await UniversalMetadataService.discoverAttributesForResourceType(resource_type, options);
+                // Include both api_slug, title, and name fields, normalize to lowercase, and dedupe
+                const attrs = attributeResult?.attributes ?? [];
+                availableAttributes = Array.from(new Set(attrs.flatMap((a) => {
+                    const attrObj = a;
+                    return [
+                        attrObj?.api_slug,
+                        attrObj?.title,
+                        attrObj?.name, // accept all, some schemas use `title`, some `name`
+                    ].filter((s) => typeof s === 'string');
+                }))).map((s) => s.toLowerCase());
+            }
+            catch (error) {
+                // If attribute discovery fails, proceed without it (fallback behavior)
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                logger.warn(ERROR_MESSAGES.ATTRIBUTE_DISCOVERY_FAILED(resource_type), {
+                    resource_type,
+                    fallback: 'proceeding without attributes',
+                    error: errorMessage,
+                    category: ErrorCategory.EXTERNAL_SERVICE,
+                });
+                availableAttributes = undefined;
+                // If this is a critical error (auth, network), consider throwing
+                if (errorMessage.includes('401') || errorMessage.includes('403')) {
+                    throw createEnhancedValidationError(`Authentication failed during attribute discovery for ${resource_type}`, {
+                        category: ErrorCategory.AUTHENTICATION,
+                        errorCode: 'ATTR_DISCOVERY_AUTH_FAILED',
+                        suggestion: 'Check API credentials and permissions',
+                        remediation: [
+                            'Verify ATTIO_API_KEY is valid and has proper permissions',
+                        ],
+                    });
+                }
+            }
+        }
+        // For records, extract objectSlug BEFORE mapping to ensure it doesn't get stripped
+        let recordsObjectSlug;
+        if (resource_type === UniversalResourceType.RECORDS) {
+            const original = record_data;
+            recordsObjectSlug = (original.object_api_slug ||
+                original.object_slug ||
+                original.object);
+            if (!recordsObjectSlug || typeof recordsObjectSlug !== 'string') {
+                throw new UniversalValidationError('Creating a "records" item requires an object slug (e.g., object: "companies")', ErrorType.USER_ERROR, { field: 'object' });
+            }
+            logger.debug('RECORDS objectSlug extracted', {
+                recordsObjectSlug,
+            });
+        }
+        // Map field names to correct ones with collision detection
+        const inputFields = (record_data.values || record_data);
+        const mappingResult = await mapRecordFields(resource_type, inputFields, availableAttributes);
+        if (mappingResult.errors && mappingResult.errors.length > 0) {
+            // Check if this is a field collision error
+            const firstError = mappingResult.errors[0];
+            const collisionMatch = firstError.match(/Multiple fields map to "([^"]+)": (.+)/);
+            if (collisionMatch) {
+                const [, targetField, fieldsStr] = collisionMatch;
+                const collidingFields = fieldsStr.split(', ');
+                throw createFieldCollisionError(collidingFields, targetField);
+            }
+            // Generic mapping error with enhanced details
+            throw createEnhancedValidationError(`Field mapping failed for ${resource_type}: ${mappingResult.errors.join('; ')}`, {
+                field: 'record_data',
+                errorCode: 'FIELD_MAPPING_ERROR',
+                suggestion: 'Check field names and resolve any conflicts',
+                remediation: mappingResult.errors.slice(0, MAX_VALIDATION_SUGGESTIONS),
+            });
+        }
+        const { mapped: mappedData, warnings } = mappingResult;
+        if (warnings.length > 0) {
+            logger.info('Field mapping applied with warnings', {
+                warnings,
+            });
+        }
+        // FEATURE: Enhanced validation for Issue #413 - conditionally disabled
+        // Requires: task attribute metadata API support in Attio
+        // Status: Ready for activation via ENABLE_ENHANCED_VALIDATION=true
+        if (process.env.ENABLE_ENHANCED_VALIDATION === 'true') {
+            const validation = await validateRecordFields(resource_type, mappedData, false);
+            if (!validation.isValid) {
+                const errorMessage = validation.error || 'Validation failed';
+                throw new UniversalValidationError(errorMessage, ErrorType.USER_ERROR, {
+                    suggestion: 'Please fix the validation errors and try again.',
+                    field: undefined,
+                });
+            }
+        }
+        switch (resource_type) {
+            case UniversalResourceType.COMPANIES: {
+                const { CompanyCreateStrategy } = await import('./create/strategies/CompanyCreateStrategy.js');
+                return (await new CompanyCreateStrategy().create({
+                    resourceType: resource_type,
+                    values: mappedData,
+                }));
+            }
+            case UniversalResourceType.LISTS: {
+                const { ListCreateStrategy } = await import('./create/strategies/ListCreateStrategy.js');
+                return (await new ListCreateStrategy().create({
+                    resourceType: resource_type,
+                    values: mappedData,
+                }));
+            }
+            case UniversalResourceType.PEOPLE: {
+                const { PersonCreateStrategy } = await import('./create/strategies/PersonCreateStrategy.js');
+                return (await new PersonCreateStrategy().create({
+                    resourceType: resource_type,
+                    values: mappedData,
+                }));
+            }
+            case UniversalResourceType.RECORDS: {
+                const { RecordCreateStrategy } = await import('./create/strategies/RecordCreateStrategy.js');
+                const context = { objectSlug: recordsObjectSlug };
+                return (await new RecordCreateStrategy().create({
+                    resourceType: resource_type,
+                    values: mappedData,
+                    context,
+                }));
+            }
+            case UniversalResourceType.DEALS: {
+                const { DealCreateStrategy } = await import('./create/strategies/DealCreateStrategy.js');
+                return (await new DealCreateStrategy().create({
+                    resourceType: resource_type,
+                    values: mappedData,
+                }));
+            }
+            case UniversalResourceType.TASKS: {
+                const { TaskCreateStrategy } = await import('./create/strategies/TaskCreateStrategy.js');
+                return (await new TaskCreateStrategy().create({
+                    resourceType: resource_type,
+                    values: mappedData,
+                }));
+            }
+            case UniversalResourceType.NOTES: {
+                const { NoteCreateStrategy } = await import('./create/strategies/NoteCreateStrategy.js');
+                return (await new NoteCreateStrategy().create({
+                    resourceType: resource_type,
+                    values: mappedData,
+                }));
+            }
+            default:
+                return this.handleUnsupportedResourceType(resource_type, params);
+        }
+    }
+    // (All resource-specific create flows are implemented by strategies above.)
+    /**
+     * Handle unsupported resource types with correction attempts
+     */
+    static async handleUnsupportedResourceType(resource_type, params) {
+        // Check if resource type can be corrected
+        const resourceValidation = validateResourceType(resource_type);
+        if (resourceValidation.corrected) {
+            // Retry with corrected resource type
+            logger.info('Resource type corrected', {
+                originalType: resource_type,
+                correctedType: resourceValidation.corrected,
+            });
+            return this.createRecord({
+                ...params,
+                resource_type: resourceValidation.corrected,
+            });
+        }
+        throw new UniversalValidationError(`Unsupported resource type: ${resource_type}`, ErrorType.USER_ERROR, {
+            suggestion: resourceValidation.suggestion ||
+                `Valid resource types are: ${getValidResourceTypes()}`,
+        });
+    }
+}
+//# sourceMappingURL=UniversalCreateService.js.map

package/dist/services/UniversalCreateService.js.map

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

package/dist/services/UniversalDeleteService.d.ts

@@ -0,0 +1,31 @@
+/**
+ * UniversalDeleteService - Centralized record deletion operations
+ *
+ * Extracted from shared-handlers.ts as part of Issue #489 Phase 3.
+ * Provides universal delete functionality across all resource types.
+ */
+import type { UniversalDeleteParams } from '../handlers/tool-configs/universal/types.js';
+/**
+ * UniversalDeleteService provides centralized record deletion functionality
+ *
+ * **Type Safety Improvements**: This service now uses shared type definitions from
+ * universal-service-types.ts to eliminate repeated inline types and improve
+ * runtime safety through type guards.
+ *
+ * **Record<string, unknown> vs any**: Throughout this service, we use
+ * Record<string, unknown> instead of any for better type safety. This allows
+ * property access while preventing unsafe operations on unknown data structures.
+ */
+export declare class UniversalDeleteService {
+    /**
+     * Delete a record across any supported resource type
+     *
+     * @param params - Delete operation parameters
+     * @returns Promise resolving to success status and record ID
+     */
+    static deleteRecord(params: UniversalDeleteParams): Promise<{
+        success: boolean;
+        record_id: string;
+    }>;
+}
+//# sourceMappingURL=UniversalDeleteService.d.ts.map

package/dist/services/UniversalDeleteService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UniversalDeleteService.d.ts","sourceRoot":"","sources":["../../src/services/UniversalDeleteService.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6CAA6C,CAAC;AAqBzF;;;;;;;;;;GAUG;AACH,qBAAa,sBAAsB;IACjC;;;;;OAKG;WACU,YAAY,CACvB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CAgLpD"}