attio-mcp 0.1.2 → 1.1.0

package/dist/utils/enhanced-validation.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Enhanced validation utilities for Attio API field validation
+ * Provides comprehensive validation based on Attio attribute metadata
+ */
+import { ValidationResult } from './validation.js';
+/**
+ * Enhanced validation result with detailed error information
+ */
+export interface EnhancedValidationResult extends ValidationResult {
+    warnings: string[];
+    readOnlyFields?: string[];
+    missingFields?: string[];
+    invalidFields?: string[];
+    error?: string;
+}
+/**
+ * Enhanced error response with actionable information
+ */
+export interface EnhancedErrorResponse {
+    error: string;
+    warnings: string[];
+    operation: string;
+    suggestions?: string[];
+    invalidFields?: string[];
+    missingFields?: string[];
+}
+/**
+ * Validate read-only fields against provided data
+ */
+export declare function validateReadOnlyFields(data: Record<string, unknown>, readOnlyFields: string[]): EnhancedValidationResult;
+/**
+ * Validate field existence for required fields
+ */
+export declare function validateFieldExistence(data: Record<string, unknown>, requiredFields: string[]): EnhancedValidationResult;
+/**
+ * Validate select field values against allowed options
+ */
+export declare function validateSelectField(value: unknown, options: string[], fieldName?: string): EnhancedValidationResult;
+/**
+ * Comprehensive record field validation using Attio metadata
+ */
+export declare function validateRecordFields(resourceType: string, data: Record<string, unknown>, isUpdate: boolean): Promise<EnhancedValidationResult>;
+/**
+ * Create enhanced error response with actionable suggestions
+ */
+export declare function createEnhancedErrorResponse(validation: EnhancedValidationResult, operation: string): EnhancedErrorResponse;
+//# sourceMappingURL=enhanced-validation.d.ts.map

package/dist/utils/enhanced-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enhanced-validation.d.ts","sourceRoot":"","sources":["../../src/utils/enhanced-validation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAMnD;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,gBAAgB;IAChE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,cAAc,EAAE,MAAM,EAAE,GACvB,wBAAwB,CAkB1B;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,cAAc,EAAE,MAAM,EAAE,GACvB,wBAAwB,CAmB1B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,MAAM,EAAE,EACjB,SAAS,CAAC,EAAE,MAAM,GACjB,wBAAwB,CAiC1B;AA2FD;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,wBAAwB,CAAC,CAwGnC;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,wBAAwB,EACpC,SAAS,EAAE,MAAM,GAChB,qBAAqB,CA2CvB"}

package/dist/utils/enhanced-validation.js

@@ -0,0 +1,254 @@
+/**
+ * Enhanced validation utilities for Attio API field validation
+ * Provides comprehensive validation based on Attio attribute metadata
+ */
+import { getObjectAttributeMetadata, getFieldValidationRules, } from '../api/attribute-types.js';
+/**
+ * Validate read-only fields against provided data
+ */
+export function validateReadOnlyFields(data, readOnlyFields) {
+    const errors = [];
+    const warnings = [];
+    const violatedFields = [];
+    for (const field of readOnlyFields) {
+        if (field in data && data[field] !== undefined) {
+            errors.push(`Field '${field}' is read-only and cannot be modified`);
+            violatedFields.push(field);
+        }
+    }
+    return {
+        isValid: errors.length === 0,
+        errors,
+        warnings,
+        readOnlyFields: violatedFields,
+    };
+}
+/**
+ * Validate field existence for required fields
+ */
+export function validateFieldExistence(data, requiredFields) {
+    const errors = [];
+    const warnings = [];
+    const missing = [];
+    for (const field of requiredFields) {
+        const value = data[field];
+        if (value === undefined || value === null || value === '') {
+            errors.push(`Required field '${field}' is missing or empty`);
+            missing.push(field);
+        }
+    }
+    return {
+        isValid: errors.length === 0,
+        errors,
+        warnings,
+        missingFields: missing,
+    };
+}
+/**
+ * Validate select field values against allowed options
+ */
+export function validateSelectField(value, options, fieldName) {
+    const errors = [];
+    const warnings = [];
+    const fieldLabel = fieldName || 'field';
+    if (value === undefined || value === null) {
+        return { isValid: true, errors, warnings };
+    }
+    // Handle array values (multiselect)
+    if (Array.isArray(value)) {
+        for (const item of value) {
+            if (typeof item === 'string' && !options.includes(item)) {
+                errors.push(`Invalid option '${item}' for ${fieldLabel}. Valid options: ${options.join(', ')}`);
+            }
+        }
+    }
+    else if (typeof value === 'string' && !options.includes(value)) {
+        errors.push(`Invalid option '${value}' for ${fieldLabel}. Valid options: ${options.join(', ')}`);
+    }
+    return {
+        isValid: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+/**
+ * Validate field type and format
+ */
+async function validateFieldType(fieldName, value, rules) {
+    const errors = [];
+    const warnings = [];
+    if (value === undefined || value === null) {
+        if (rules.required) {
+            errors.push(`Required field '${fieldName}' cannot be null or undefined`);
+        }
+        return { isValid: errors.length === 0, errors, warnings };
+    }
+    // Type validation
+    switch (rules.type) {
+        case 'string':
+            if (typeof value !== 'string') {
+                errors.push(`Field '${fieldName}' must be a string, got ${typeof value}`);
+            }
+            break;
+        case 'number':
+            if (typeof value !== 'number' || isNaN(value)) {
+                errors.push(`Field '${fieldName}' must be a valid number`);
+            }
+            break;
+        case 'boolean':
+            if (typeof value !== 'boolean') {
+                errors.push(`Field '${fieldName}' must be a boolean`);
+            }
+            break;
+        case 'array':
+            if (!Array.isArray(value)) {
+                errors.push(`Field '${fieldName}' must be an array`);
+            }
+            break;
+        case 'object':
+            if (typeof value !== 'object' || Array.isArray(value)) {
+                errors.push(`Field '${fieldName}' must be an object`);
+            }
+            break;
+    }
+    // Pattern validation (email, URL, phone)
+    if (rules.pattern && typeof value === 'string') {
+        const regex = new RegExp(rules.pattern);
+        if (!regex.test(value)) {
+            switch (rules.pattern) {
+                case '^[^@]+@[^@]+\\.[^@]+$':
+                    errors.push(`Field '${fieldName}' must be a valid email address`);
+                    break;
+                case '^https?://':
+                    errors.push(`Field '${fieldName}' must be a valid URL starting with http:// or https://`);
+                    break;
+                case '^\\+?[0-9-()\\s]+$':
+                    errors.push(`Field '${fieldName}' must be a valid phone number`);
+                    break;
+                default:
+                    errors.push(`Field '${fieldName}' does not match required format`);
+            }
+        }
+    }
+    // Enum validation for select fields
+    if (rules.enum && rules.enum.length > 0) {
+        const selectValidation = validateSelectField(value, rules.enum.map(String), fieldName);
+        errors.push(...selectValidation.errors);
+        warnings.push(...selectValidation.warnings);
+    }
+    return {
+        isValid: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+/**
+ * Comprehensive record field validation using Attio metadata
+ */
+export async function validateRecordFields(resourceType, data, isUpdate) {
+    const errors = [];
+    const warnings = [];
+    const invalidFields = [];
+    const missingFields = [];
+    const readOnlyFields = [];
+    try {
+        // Get attribute metadata for the resource type
+        const attributeMetadata = await getObjectAttributeMetadata(resourceType);
+        if (attributeMetadata.size === 0) {
+            warnings.push(`No attribute metadata found for resource type '${resourceType}'. Validation may be incomplete.`);
+        }
+        // Validate each field in the data
+        for (const [fieldName, value] of Object.entries(data)) {
+            const metadata = attributeMetadata.get(fieldName);
+            if (!metadata) {
+                // For tasks, provide specific guidance about invalid fields (Issue #417)
+                if (resourceType === 'tasks') {
+                    errors.push(`Field '${fieldName}' is not recognized for tasks. Valid task fields are: content, status, due_date, assignee_id, record_id`);
+                    invalidFields.push(fieldName);
+                }
+                else {
+                    warnings.push(`Field '${fieldName}' is not recognized for resource type '${resourceType}'`);
+                }
+                continue;
+            }
+            // Check if field is writable
+            if (metadata.is_writable === false) {
+                errors.push(`Field '${fieldName}' is read-only and cannot be modified`);
+                readOnlyFields.push(fieldName);
+                invalidFields.push(fieldName);
+                continue;
+            }
+            // Get validation rules for this field
+            try {
+                const validationRules = await getFieldValidationRules(resourceType, fieldName);
+                // Validate field type and format
+                const typeValidation = await validateFieldType(fieldName, value, validationRules);
+                errors.push(...typeValidation.errors);
+                warnings.push(...typeValidation.warnings);
+                if (!typeValidation.isValid) {
+                    invalidFields.push(fieldName);
+                }
+            }
+            catch (ruleError) {
+                warnings.push(`Could not get validation rules for field '${fieldName}': ${ruleError instanceof Error ? ruleError.message : 'Unknown error'}`);
+            }
+        }
+        // For create operations, check required fields
+        if (!isUpdate) {
+            const requiredFields = [];
+            for (const [fieldName, metadata] of Array.from(attributeMetadata)) {
+                if (metadata.is_required && metadata.is_writable !== false) {
+                    requiredFields.push(fieldName);
+                }
+            }
+            const requiredFieldValidation = validateFieldExistence(data, requiredFields);
+            errors.push(...requiredFieldValidation.errors);
+            warnings.push(...requiredFieldValidation.warnings);
+            missingFields.push(...(requiredFieldValidation.missingFields || []));
+        }
+    }
+    catch (metadataError) {
+        const errorMessage = metadataError instanceof Error ? metadataError.message : 'Unknown error';
+        errors.push(`Failed to validate fields: ${errorMessage}`);
+    }
+    return {
+        isValid: errors.length === 0,
+        errors,
+        warnings,
+        readOnlyFields,
+        missingFields,
+        invalidFields,
+    };
+}
+/**
+ * Create enhanced error response with actionable suggestions
+ */
+export function createEnhancedErrorResponse(validation, operation) {
+    const suggestions = [];
+    // Generate helpful suggestions based on validation errors
+    if (validation.missingFields && validation.missingFields.length > 0) {
+        suggestions.push(`Add required fields: ${validation.missingFields.join(', ')}`);
+    }
+    if (validation.readOnlyFields && validation.readOnlyFields.length > 0) {
+        suggestions.push(`Remove read-only fields: ${validation.readOnlyFields.join(', ')}`);
+    }
+    if (validation.invalidFields && validation.invalidFields.length > 0) {
+        suggestions.push(`Fix invalid field values for: ${validation.invalidFields.join(', ')}`);
+    }
+    // Add operation-specific suggestions
+    if (operation === 'create-record' && validation.missingFields?.length) {
+        suggestions.push('Ensure all required fields have values before creating a record');
+    }
+    if (operation === 'update-record' && validation.readOnlyFields?.length) {
+        suggestions.push('Use separate calls to update read-only fields if they support it, or remove them from the update');
+    }
+    return {
+        error: validation.errors.join('; '),
+        warnings: validation.warnings,
+        operation,
+        suggestions: suggestions.length > 0 ? suggestions : undefined,
+        invalidFields: validation.invalidFields,
+        missingFields: validation.missingFields,
+    };
+}
+//# sourceMappingURL=enhanced-validation.js.map

package/dist/utils/enhanced-validation.js.map

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

package/dist/utils/error-detection.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Explicit error detection utilities for MCP responses
+ *
+ * Provides precise error detection logic to avoid false positives
+ * from string-based heuristics and empty/false responses that
+ * are actually valid success states.
+ */
+export interface ErrorAnalysis {
+    isError: boolean;
+    reason?: 'null_or_undefined_result' | 'empty_response' | 'explicit_success_false' | 'meaningful_error_object' | 'meaningful_error_string' | 'errors_array_has_items' | 'api_error_array' | 'empty_array';
+}
+/**
+ * Compute error status with explicit detection logic only
+ *
+ * Avoids false positives by only flagging:
+ * - Null/undefined results
+ * - Explicit success: false
+ * - Meaningful error objects with messages
+ * - Non-empty error strings
+ * - Error arrays with actual error items
+ *
+ * @param result - Result object to analyze
+ * @param opts - Optional context for tool-specific logic
+ * @returns Error analysis with explicit reasoning
+ */
+export declare function computeErrorWithContext(result: unknown, opts?: {
+    toolName?: string;
+    httpStatus?: number;
+}): ErrorAnalysis;
+/**
+ * Check if a result should have empty error fields removed
+ *
+ * @param result - Result to clean
+ * @returns Cleaned result without empty error indicators
+ */
+export declare function cleanEmptyErrorFields(result: unknown): unknown;
+//# sourceMappingURL=error-detection.d.ts.map

package/dist/utils/error-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-detection.d.ts","sourceRoot":"","sources":["../../src/utils/error-detection.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EACH,0BAA0B,GAC1B,gBAAgB,GAChB,wBAAwB,GACxB,yBAAyB,GACzB,yBAAyB,GACzB,wBAAwB,GACxB,iBAAiB,GACjB,aAAa,CAAC;CACnB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,OAAO,EACf,IAAI,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAChD,aAAa,CA2If;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAsB9D"}

package/dist/utils/error-detection.js

@@ -0,0 +1,157 @@
+/**
+ * Explicit error detection utilities for MCP responses
+ *
+ * Provides precise error detection logic to avoid false positives
+ * from string-based heuristics and empty/false responses that
+ * are actually valid success states.
+ */
+/**
+ * Compute error status with explicit detection logic only
+ *
+ * Avoids false positives by only flagging:
+ * - Null/undefined results
+ * - Explicit success: false
+ * - Meaningful error objects with messages
+ * - Non-empty error strings
+ * - Error arrays with actual error items
+ *
+ * @param result - Result object to analyze
+ * @param opts - Optional context for tool-specific logic
+ * @returns Error analysis with explicit reasoning
+ */
+export function computeErrorWithContext(result, opts) {
+    const toolName = opts?.toolName;
+    const isPlainObject = result && typeof result === 'object' && !Array.isArray(result);
+    const isEmptyObject = isPlainObject &&
+        Object.keys(result).length === 0;
+    // 1) Always surface explicit API errors first
+    const apiResponse = result;
+    if (apiResponse?.error ||
+        (Array.isArray(apiResponse?.errors) && apiResponse.errors.length)) {
+        return { isError: true, reason: 'meaningful_error_object' };
+    }
+    // Handle arrays (bulk ops, list endpoints, etc.)
+    if (Array.isArray(result)) {
+        // explicit errors inside any element
+        const hasExplicitErr = result.some((r) => r?.error || (Array.isArray(r?.errors) && r.errors.length));
+        if (hasExplicitErr)
+            return { isError: true, reason: 'api_error_array' };
+        // empty arrays are usually a failure for create/bulk flows
+        if (result.length === 0)
+            return { isError: true, reason: 'empty_array' };
+        return { isError: false };
+    }
+    // 2) Create-record special case:
+    //    On 2xx paths the transport may hand minimal shells through;
+    //    don't classify {} as an error here — let the business layer
+    //    (extractor/assert) decide shape.
+    if (toolName === 'create-record') {
+        if (result == null)
+            return { isError: true, reason: 'null_or_undefined_result' };
+        if (isEmptyObject)
+            return { isError: false };
+    }
+    // 3) Legacy heuristics (unchanged for other tools)
+    if (result == null)
+        return { isError: true, reason: 'null_or_undefined_result' };
+    if (isEmptyObject)
+        return { isError: true, reason: 'empty_response' };
+    // Detect empty objects as errors (per Issue #517 analysis)
+    // Empty objects {} often indicate failed API responses that should be errors
+    // Detect Attio API "unknown" record responses (indicates record not found)
+    // Attio sometimes returns fake records with id.record_id: 'unknown' instead of 404s
+    if (result && typeof result === 'object' && !Array.isArray(result)) {
+        const record = result;
+        if (record.id &&
+            typeof record.id === 'object' &&
+            !Array.isArray(record.id)) {
+            const id = record.id;
+            if (id.record_id === 'unknown') {
+                return { isError: true, reason: 'empty_response' };
+            }
+        }
+    }
+    // Check for explicit success: false
+    if (typeof result === 'object' && result !== null && 'success' in result) {
+        const successField = result.success;
+        if (successField === false) {
+            return { isError: true, reason: 'explicit_success_false' };
+        }
+    }
+    // Check for meaningful error objects
+    if (typeof result === 'object' && result !== null && 'error' in result) {
+        const errorField = result.error;
+        // Error object with message
+        if (errorField &&
+            typeof errorField === 'object' &&
+            'message' in errorField) {
+            const message = errorField.message;
+            if (typeof message === 'string' && message.trim()) {
+                return { isError: true, reason: 'meaningful_error_object' };
+            }
+        }
+        // Error string (non-empty)
+        if (typeof errorField === 'string' && errorField.trim().length > 0) {
+            return { isError: true, reason: 'meaningful_error_string' };
+        }
+    }
+    // Check for errors array with meaningful items
+    if (typeof result === 'object' && result !== null && 'errors' in result) {
+        const errorsField = result.errors;
+        if (Array.isArray(errorsField)) {
+            const hasErrors = errorsField.some((err) => {
+                if (!err)
+                    return false;
+                // Error with message
+                if (typeof err === 'object' && 'message' in err) {
+                    const message = err.message;
+                    return typeof message === 'string' && message.trim();
+                }
+                // Error with code
+                if (typeof err === 'object' && 'code' in err) {
+                    return true;
+                }
+                // Non-empty error string
+                if (typeof err === 'string') {
+                    return err.trim().length > 0;
+                }
+                return false;
+            });
+            if (hasErrors) {
+                return { isError: true, reason: 'errors_array_has_items' };
+            }
+        }
+    }
+    // Default to no error for all other cases
+    // This includes:
+    // - Empty arrays: []
+    // - Empty strings: ""
+    // - false/null values in data fields
+    // - Missing fields
+    // - Zero counts
+    return { isError: false };
+}
+/**
+ * Check if a result should have empty error fields removed
+ *
+ * @param result - Result to clean
+ * @returns Cleaned result without empty error indicators
+ */
+export function cleanEmptyErrorFields(result) {
+    if (!result || typeof result !== 'object') {
+        return result;
+    }
+    const cleaned = { ...result };
+    // Remove empty error field
+    if ('error' in cleaned && (cleaned.error === '' || cleaned.error === null)) {
+        delete cleaned.error;
+    }
+    // Remove empty errors array
+    if ('errors' in cleaned &&
+        Array.isArray(cleaned.errors) &&
+        cleaned.errors.length === 0) {
+        delete cleaned.errors;
+    }
+    return cleaned;
+}
+//# sourceMappingURL=error-detection.js.map

package/dist/utils/error-detection.js.map

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

package/dist/utils/error-enhancer.d.ts

@@ -1,11 +1,12 @@
+import type { UnknownObject } from './types/common.js';
 /**
  * Enhance an API error with value suggestions if applicable
  */
-export declare function enhanceApiError(error: any): Error;
+export declare function enhanceApiError(error: UnknownObject): Error;
 /**
  * Check if an error is a value mismatch that we can enhance
  */
-export declare function isValueMismatchError(error: any): {
+export declare function isValueMismatchError(error: UnknownObject): {
     isMismatch: boolean;
     fieldSlug?: string;
     searchValue?: string;

package/dist/utils/error-enhancer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-enhancer.d.ts","sourceRoot":"","sources":["../../src/utils/error-enhancer.ts"],"names":[],"mappings":"AAoLA;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK,CAiEjD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,GAAG,GAAG;IAChD,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAiCA;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAEtE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EAAE,GACf,IAAI,CAEN"}
+{"version":3,"file":"error-enhancer.d.ts","sourceRoot":"","sources":["../../src/utils/error-enhancer.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAwJvD;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,KAAK,CAqD3D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,aAAa,GAAG;IAC1D,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAkCA;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAEtE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EAAE,GACf,IAAI,CAEN"}