@iflow-mcp/attio-mcp 1.3.6

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

@@ -0,0 +1,305 @@
+import { getAttributesSchema, discoverAttributesSchema, getAttributeOptionsSchema, validateUniversalToolParams, } from '../schemas.js';
+import { handleUniversalGetAttributes, handleUniversalDiscoverAttributes, handleUniversalGetAttributeOptions, getSingularResourceType, } from '../shared-handlers.js';
+import { formatToolDescription } from '../../../../handlers/tools/standards/index.js';
+function extractResourceTypeFromFormatArgs(args) {
+    const first = args[0];
+    if (typeof first === 'string') {
+        return first;
+    }
+    if (first && typeof first === 'object' && 'resource_type' in first) {
+        const candidate = first.resource_type;
+        if (typeof candidate === 'string') {
+            return candidate;
+        }
+    }
+    return undefined;
+}
+export const getAttributesConfig = {
+    name: 'get_record_attributes',
+    handler: async (params) => {
+        try {
+            const sanitizedParams = validateUniversalToolParams('get_record_attributes', params);
+            return await handleUniversalGetAttributes(sanitizedParams);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return { error: errorMessage, success: false };
+        }
+    },
+    formatResult: (attributes, ...args) => {
+        const resourceType = extractResourceTypeFromFormatArgs(args);
+        if (!attributes) {
+            return 'No attributes found';
+        }
+        const resourceTypeName = resourceType
+            ? getSingularResourceType(resourceType)
+            : 'record';
+        if (Array.isArray(attributes)) {
+            return `${resourceTypeName.charAt(0).toUpperCase() + resourceTypeName.slice(1)} attributes (${attributes.length}):\n${attributes
+                .map((attr, index) => {
+                const name = attr.title || attr.api_slug || attr.name || attr.slug || 'Unnamed';
+                const type = attr.type || 'unknown';
+                return `${index + 1}. ${name} (${type})`;
+            })
+                .join('\n')}`;
+        }
+        if (typeof attributes === 'object' && attributes !== null) {
+            if (attributes.all && Array.isArray(attributes.all)) {
+                return `Available ${resourceTypeName} attributes (${attributes.all.length}):\n${attributes.all
+                    .map((attr, index) => {
+                    const name = attr.title ||
+                        attr.api_slug ||
+                        attr.name ||
+                        attr.slug ||
+                        'Unnamed';
+                    const type = attr.type || 'unknown';
+                    return `${index + 1}. ${name} (${type})`;
+                })
+                    .join('\n')}`;
+            }
+            if (attributes.attributes && Array.isArray(attributes.attributes)) {
+                return `Available ${resourceTypeName} attributes (${attributes.attributes.length}):\n${attributes.attributes
+                    .map((attr, index) => {
+                    const name = attr.name || attr.api_slug || attr.slug || 'Unnamed';
+                    const type = attr.type || 'unknown';
+                    return `${index + 1}. ${name} (${type})`;
+                })
+                    .join('\n')}`;
+            }
+            const keys = Object.keys(attributes);
+            if (keys.length > 0) {
+                return `${resourceTypeName.charAt(0).toUpperCase() + resourceTypeName.slice(1)} attributes (${keys.length}):\n${keys
+                    .map((key, index) => {
+                    const value = attributes[key];
+                    if (typeof value === 'string') {
+                        return `${index + 1}. ${key}: "${value}"`;
+                    }
+                    return `${index + 1}. ${key}`;
+                })
+                    .join('\n')}`;
+            }
+        }
+        return `${resourceTypeName.charAt(0).toUpperCase() + resourceTypeName.slice(1)} attributes available`;
+    },
+};
+export const discoverAttributesConfig = {
+    name: 'discover_record_attributes',
+    handler: async (params) => {
+        try {
+            const sanitizedParams = validateUniversalToolParams('discover_record_attributes', params);
+            return await handleUniversalDiscoverAttributes(sanitizedParams.resource_type, {
+                categories: sanitizedParams.categories,
+            });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return { error: errorMessage, success: false };
+        }
+    },
+    formatResult: (schema, ...args) => {
+        const resourceType = extractResourceTypeFromFormatArgs(args);
+        if (!schema) {
+            return 'No attribute schema found';
+        }
+        const resourceTypeName = resourceType
+            ? getSingularResourceType(resourceType)
+            : 'record';
+        if (Array.isArray(schema)) {
+            return `Available ${resourceTypeName} attributes (${schema.length}):\n${schema
+                .map((attr, index) => {
+                const name = attr.title || attr.api_slug || attr.name || attr.slug || 'Unnamed';
+                const type = attr.type || 'unknown';
+                const required = attr.required ? ' (required)' : '';
+                return `${index + 1}. ${name} (${type})${required}`;
+            })
+                .join('\n')}`;
+        }
+        if (typeof schema === 'object' && schema !== null) {
+            const schemaRecord = schema;
+            if (schemaRecord.all && Array.isArray(schemaRecord.all)) {
+                return `Available ${resourceTypeName} attributes (${schemaRecord.all.length}):\n${schemaRecord.all
+                    .map((attr, index) => {
+                    const name = attr.title ||
+                        attr.api_slug ||
+                        attr.name ||
+                        attr.slug ||
+                        'Unnamed';
+                    const type = attr.type || 'unknown';
+                    const required = attr.required ? ' (required)' : '';
+                    return `${index + 1}. ${name} (${type})${required}`;
+                })
+                    .join('\n')}`;
+            }
+            if (schemaRecord.attributes && Array.isArray(schemaRecord.attributes)) {
+                return `Available ${resourceTypeName} attributes (${schemaRecord.attributes.length}):\n${schemaRecord.attributes
+                    .map((attr, index) => {
+                    const name = attr.title ||
+                        attr.api_slug ||
+                        attr.name ||
+                        attr.slug ||
+                        'Unnamed';
+                    const type = attr.type || 'unknown';
+                    const required = attr.required ? ' (required)' : '';
+                    return `${index + 1}. ${name} (${type})${required}`;
+                })
+                    .join('\n')}`;
+            }
+            if (schemaRecord.standard || schemaRecord.custom) {
+                const standard = schemaRecord.standard || [];
+                const custom = schemaRecord.custom || [];
+                const total = standard.length + custom.length;
+                let result = `Available ${resourceTypeName} attributes (${total} total):\n`;
+                if (standard.length > 0) {
+                    result += `\nStandard attributes (${standard.length}):\n${standard
+                        .map((attr, index) => {
+                        const name = attr.title ||
+                            attr.api_slug ||
+                            attr.name ||
+                            attr.slug ||
+                            'Unnamed';
+                        const type = attr.type || 'unknown';
+                        return `${index + 1}. ${name} (${type})`;
+                    })
+                        .join('\n')}`;
+                }
+                if (custom.length > 0) {
+                    result += `\n\nCustom attributes (${custom.length}):\n${custom
+                        .map((attr, index) => {
+                        const name = attr.title ||
+                            attr.api_slug ||
+                            attr.name ||
+                            attr.slug ||
+                            'Unnamed';
+                        const type = attr.type || 'unknown';
+                        return `${standard.length + index + 1}. ${name} (${type})`;
+                    })
+                        .join('\n')}`;
+                }
+                return result;
+            }
+        }
+        return `${resourceTypeName.charAt(0).toUpperCase() + resourceTypeName.slice(1)} attribute schema available`;
+    },
+};
+export const getAttributesDefinition = {
+    name: 'get_record_attributes',
+    description: formatToolDescription({
+        capability: 'Retrieve attribute metadata for a given resource type.',
+        boundaries: 'modify schema definitions or record data.',
+        constraints: 'Requires resource_type; optional categories narrows groups.',
+        recoveryHint: 'Use records.discover_attributes for grouped schema discovery.',
+    }),
+    inputSchema: getAttributesSchema,
+    annotations: {
+        readOnlyHint: true,
+        idempotentHint: true,
+    },
+};
+export const discoverAttributesDefinition = {
+    name: 'discover_record_attributes',
+    description: formatToolDescription({
+        capability: 'Discover available attributes (standard/custom) for a resource.',
+        boundaries: 'alter schema or create fields.',
+        constraints: 'Requires resource_type; optional categories selects subsets.',
+        recoveryHint: 'For select/status attributes, use get_record_attribute_options to fetch valid values before creating or updating records.',
+    }),
+    inputSchema: discoverAttributesSchema,
+    annotations: {
+        readOnlyHint: true,
+        idempotentHint: true,
+    },
+};
+/**
+ * Tool config for getting attribute options (select, multi-select, status)
+ */
+let lastGetAttributeOptionsParams = null;
+export const getAttributeOptionsConfig = {
+    name: 'get_record_attribute_options',
+    handler: async (params) => {
+        try {
+            const sanitizedParams = validateUniversalToolParams('get_record_attribute_options', params);
+            lastGetAttributeOptionsParams = sanitizedParams;
+            return await handleUniversalGetAttributeOptions(sanitizedParams);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            lastGetAttributeOptionsParams = params;
+            return { error: errorMessage, success: false };
+        }
+    },
+    formatResult: (result, ...args) => {
+        // Handle error response
+        if ('error' in result && 'success' in result) {
+            return `Error: ${result.error}`;
+        }
+        // Extract params from args - handle both new format (full args object) and legacy (resource_type string)
+        let resourceType;
+        let attribute = 'attribute'; // fallback
+        const firstArg = args[0];
+        if (typeof firstArg === 'object' && firstArg !== null) {
+            // New format: args[0] is the full params object
+            const params = firstArg;
+            resourceType = params.resource_type;
+            attribute = params.attribute || 'attribute';
+        }
+        else if (typeof firstArg === 'string') {
+            // Legacy format: args[0] is resource_type string
+            resourceType = firstArg;
+        }
+        else if (lastGetAttributeOptionsParams) {
+            resourceType = lastGetAttributeOptionsParams.resource_type;
+            attribute = lastGetAttributeOptionsParams.attribute || attribute;
+        }
+        const resourceTypeName = resourceType
+            ? getSingularResourceType(resourceType)
+            : 'record';
+        const { options, attributeType } = result;
+        if (!options || !Array.isArray(options) || options.length === 0) {
+            return (`No options found for attribute "${attribute}" on ${resourceTypeName}.\n\n` +
+                `This could mean:\n` +
+                `- The attribute has no configured options yet\n` +
+                `- The attribute is not a select, multi-select, or status type\n\n` +
+                `Hint: Use discover_record_attributes to verify the attribute type.`);
+        }
+        // Separate active and archived options
+        const activeOptions = options.filter((opt) => !opt.is_archived);
+        const archivedOptions = options.filter((opt) => opt.is_archived);
+        const typeLabel = attributeType === 'status' ? 'status' : 'select';
+        let output = `Options for "${attribute}" (${typeLabel}) attribute on ${resourceTypeName}:\n\n`;
+        if (activeOptions.length > 0) {
+            output += `Active options (${activeOptions.length}):\n`;
+            activeOptions.forEach((opt, index) => {
+                output += `  ${index + 1}. "${opt.title}"\n`;
+            });
+        }
+        if (archivedOptions.length > 0) {
+            output += `\nArchived options (${archivedOptions.length}):\n`;
+            archivedOptions.forEach((opt, index) => {
+                output += `  ${activeOptions.length + index + 1}. "${opt.title}" (archived)\n`;
+            });
+        }
+        output += `\nTotal: ${options.length} option${options.length !== 1 ? 's' : ''}`;
+        if (archivedOptions.length > 0) {
+            output += ` (${activeOptions.length} active, ${archivedOptions.length} archived)`;
+        }
+        // Add helpful hint
+        const exampleOption = activeOptions[0]?.title || options[0]?.title;
+        output += `\n\nHint: Use the option title (e.g., "${exampleOption}") when setting this attribute value.`;
+        return output;
+    },
+};
+export const getAttributeOptionsDefinition = {
+    name: 'get_record_attribute_options',
+    description: formatToolDescription({
+        capability: 'Get valid options for select, multi-select, and status attributes to avoid "Cannot find select option" errors.',
+        boundaries: 'return options for text, number, or other non-option types.',
+        constraints: 'Requires resource_type and attribute slug/ID.',
+        recoveryHint: 'Use discover_record_attributes to find option-based attributes first. Use retrieved option titles when calling create-record or update-record.',
+    }),
+    inputSchema: getAttributeOptionsSchema,
+    annotations: {
+        readOnlyHint: true,
+        idempotentHint: true,
+    },
+};
+//# sourceMappingURL=metadata-operations.js.map

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

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

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

@@ -0,0 +1,82 @@
+import { UniversalToolConfig } from '../../../../handlers/tool-configs/universal/types.js';
+export declare const createNoteConfig: UniversalToolConfig<Record<string, unknown>, Record<string, unknown>>;
+export declare const listNotesConfig: UniversalToolConfig<Record<string, unknown>, Record<string, unknown>[]>;
+export declare const createNoteDefinition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            resource_type: {
+                type: "string";
+                enum: import("../../../../handlers/tool-configs/universal/types.js").UniversalResourceType[];
+                description: string;
+            };
+            record_id: {
+                type: "string";
+                description: string;
+            };
+            title: {
+                type: "string";
+                description: string;
+            };
+            content: {
+                type: "string";
+                description: string;
+            };
+            format: {
+                type: "string";
+                enum: string[];
+                description: string;
+                default: string;
+            };
+        };
+        required: ("title" | "content" | "record_id" | "resource_type")[];
+        additionalProperties: boolean;
+    };
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+    };
+};
+export declare const listNotesDefinition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            limit: {
+                type: "number";
+                minimum: number;
+                maximum: number;
+                default: number;
+                description: string;
+            };
+            offset: {
+                type: "number";
+                minimum: number;
+                default: number;
+                description: string;
+            };
+            resource_type: {
+                type: "string";
+                description: string;
+            };
+            record_id: {
+                type: "string";
+                description: string;
+            };
+            parent_record_id: {
+                type: "string";
+                description: string;
+            };
+        };
+        required: "resource_type"[];
+        additionalProperties: boolean;
+    };
+    annotations: {
+        readOnlyHint: boolean;
+        idempotentHint: boolean;
+    };
+};
+//# sourceMappingURL=notes-operations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"notes-operations.d.ts","sourceRoot":"","sources":["../../../../../src/handlers/tool-configs/universal/core/notes-operations.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EAGpB,MAAM,4CAA4C,CAAC;AAoBpD,eAAO,MAAM,gBAAgB,EAAE,mBAAmB,CAChD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA+ExB,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,mBAAmB,CAC/C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAuD1B,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgBhC,CAAC;AAEF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAa/B,CAAC"}

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

@@ -0,0 +1,130 @@
+import { createNoteSchema, listNotesSchema, validateUniversalToolParams, } from '../../../../handlers/tool-configs/universal/schemas.js';
+import { handleUniversalCreateNote, handleUniversalGetNotes, } from '../../../../handlers/tool-configs/universal/shared-handlers.js';
+import { ErrorService } from '../../../../services/ErrorService.js';
+import { formatToolDescription } from '../../../../handlers/tools/standards/index.js';
+import { extractNoteFields } from '../../../../handlers/tool-configs/universal/core/utils/note-formatters.js';
+import { isValidUUID } from '../../../../utils/validation/uuid-validation.js';
+import { createErrorResult } from '../../../../utils/error-handler.js';
+export const createNoteConfig = {
+    name: 'create_note',
+    handler: async (params) => {
+        try {
+            const sanitizedParams = validateUniversalToolParams('create_note', params);
+            if (!isValidUUID(sanitizedParams.record_id)) {
+                throw new Error(`Invalid record_id: must be a UUID. Got: ${sanitizedParams.record_id}`);
+            }
+            const result = await handleUniversalCreateNote(sanitizedParams);
+            const { success, error } = result;
+            if (success === false) {
+                throw new Error(typeof error === 'string' && error.length
+                    ? error
+                    : 'Universal note creation failed');
+            }
+            return result;
+        }
+        catch (err) {
+            throw ErrorService.createUniversalError('create_note', 'notes', err);
+        }
+    },
+    formatResult: (note) => {
+        try {
+            if (!note) {
+                return 'No note created';
+            }
+            const { title, content, id } = extractNoteFields(note);
+            return `✅ Note created successfully: ${title} (ID: ${id})${content ? `\n${content}` : ''}`;
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            const fallback = createErrorResult(err, 'create_note#format', 'FORMAT');
+            const message = fallback.content?.[0]?.text;
+            return typeof message === 'string'
+                ? message
+                : 'Error formatting note result';
+        }
+    },
+    structuredOutput: (note) => {
+        if (!note)
+            return {};
+        // Normalize content fields to top-level, but preserve original id object
+        const { title, content } = extractNoteFields(note);
+        return {
+            ...note,
+            // Keep original id (object) - don't replace with extracted string
+            title: title || note.title,
+            content: content ||
+                note.content ||
+                note.content_markdown ||
+                note.content_plaintext,
+        };
+    },
+};
+export const listNotesConfig = {
+    name: 'list_notes',
+    handler: async (params) => {
+        try {
+            const sanitizedParams = validateUniversalToolParams('list_notes', params);
+            const recordId = sanitizedParams.record_id;
+            if (!recordId || typeof recordId !== 'string' || !isValidUUID(recordId)) {
+                throw new Error(`Invalid record_id: must be a UUID. Got: ${recordId ?? 'undefined'}`);
+            }
+            return await handleUniversalGetNotes(sanitizedParams);
+        }
+        catch (error) {
+            throw ErrorService.createUniversalError('list_notes', 'notes', error);
+        }
+    },
+    formatResult: (notes) => {
+        try {
+            const notesArray = Array.isArray(notes) ? notes : [];
+            if (notesArray.length === 0) {
+                return 'Found 0 notes';
+            }
+            const formattedNotes = notesArray
+                .map((note, index) => {
+                const { title, timestamp, id, preview } = extractNoteFields(note);
+                return `${index + 1}. ${title} (${timestamp}) (ID: ${id})${preview ? `\n   ${preview}` : ''}`;
+            })
+                .join('\n\n');
+            return `Found ${notesArray.length} notes:\n${formattedNotes}`;
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            const fallback = createErrorResult(err, 'list_notes#format', 'FORMAT');
+            const message = fallback.content?.[0]?.text;
+            return typeof message === 'string'
+                ? message
+                : 'Error formatting notes list';
+        }
+    },
+};
+export const createNoteDefinition = {
+    name: 'create_note',
+    description: formatToolDescription({
+        capability: 'Create note for companies, people, or deals with optional markdown formatting.',
+        boundaries: 'update or delete notes; creates only.',
+        requiresApproval: true,
+        constraints: 'Requires resource_type, record_id, title, content. Optional format (plaintext or markdown).',
+        recoveryHint: 'If record not found, use records_search first.',
+    }),
+    inputSchema: createNoteSchema,
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+    },
+};
+export const listNotesDefinition = {
+    name: 'list_notes',
+    description: formatToolDescription({
+        capability: 'Retrieve notes for a record with timestamps.',
+        boundaries: 'create or modify notes; read-only.',
+        constraints: 'Requires resource_type, record_id; sorted by creation date.',
+        recoveryHint: 'If empty, verify record has notes with records_get_details.',
+    }),
+    inputSchema: listNotesSchema,
+    annotations: {
+        readOnlyHint: true,
+        idempotentHint: true,
+    },
+};
+//# sourceMappingURL=notes-operations.js.map

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

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

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

@@ -0,0 +1,41 @@
+/**
+ * PII Sanitization for Validation Metadata
+ *
+ * Ensures that validation messages and metadata do not expose
+ * personally identifiable information (PII) in logs or user-facing messages.
+ */
+import { createScopedLogger } from '../../../../utils/logger.js';
+/**
+ * Check if a field name indicates it might contain PII
+ */
+export declare const isPotentialPIIField: (fieldName: string) => boolean;
+/**
+ * Sanitize a string value for PII
+ */
+export declare const sanitizeStringValue: (value: string) => string;
+/**
+ * Sanitize any value (string, object, array) for PII
+ */
+export declare const sanitizeValue: (value: unknown) => unknown;
+/**
+ * Sanitize validation metadata to remove PII
+ */
+export interface SanitizedValidationMetadata {
+    warnings?: string[];
+    suggestions?: string[];
+    actualValues?: Record<string, unknown>;
+}
+export declare const sanitizeValidationMetadata: (metadata?: {
+    warnings?: string[];
+    suggestions?: string[];
+    actualValues?: Record<string, unknown>;
+}) => SanitizedValidationMetadata | undefined;
+/**
+ * Enhanced format function with PII sanitization
+ */
+export declare const formatSanitizedActualValue: (value: unknown) => string;
+/**
+ * Safe logging function that sanitizes messages before logging
+ */
+export declare const sanitizedLog: (logger: ReturnType<typeof createScopedLogger>, level: "error" | "warn" | "info" | "debug", message: string, data?: Record<string, unknown>) => void;
+//# sourceMappingURL=pii-sanitizer.d.ts.map

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

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