@iflow-mcp/attio-mcp 1.3.6

package/dist/services/metadata/MetadataDiscoveryService.js

@@ -0,0 +1,139 @@
+import { getLazyAttioClient } from '../../api/lazy-client.js';
+import { OBJECT_SLUG_MAP } from '../../constants/universal.constants.js';
+import { UniversalResourceType } from '../../handlers/tool-configs/universal/types.js';
+import { secureValidateCategories } from '../../utils/validation/field-validation.js';
+import { DiscoveryRunner } from './discovery-runner.js';
+import { buildTaskMetadata } from './task-metadata.js';
+export class DefaultMetadataDiscoveryService {
+    transformService;
+    errorService;
+    runner;
+    constructor(cacheService, metricsService, transformService, errorService) {
+        this.transformService = transformService;
+        this.errorService = errorService;
+        this.runner = new DiscoveryRunner(cacheService, metricsService);
+    }
+    async discoverForType(options) {
+        if (options.resourceType === UniversalResourceType.TASKS) {
+            return this.discoverTasksWithMetrics(options);
+        }
+        if (options.resourceType === UniversalResourceType.RECORDS) {
+            return this.discoverRecordsWithMetrics(options);
+        }
+        return this.discoverStandardResource(options);
+    }
+    async discoverTasks(options) {
+        return buildTaskMetadata(this.transformService, options?.categories);
+    }
+    async discoverObject(options) {
+        const { objectSlug, categories } = options;
+        const client = getLazyAttioClient();
+        try {
+            let path = `/objects/${objectSlug}/attributes`;
+            let sanitizedCategories;
+            if (categories?.length) {
+                sanitizedCategories = secureValidateCategories(categories, 'category filtering in discover-object-attributes');
+                if (sanitizedCategories.length > 0) {
+                    path += `?categories=${encodeURIComponent(sanitizedCategories.join(','))}`;
+                }
+            }
+            const response = await client.get(path);
+            const parsed = this.transformService.parseAttributesResponse(response?.data);
+            const filtered = sanitizedCategories?.length
+                ? this.transformService.filterByCategory(parsed, sanitizedCategories)
+                : parsed;
+            const mappings = this.transformService.buildMappings(filtered);
+            return {
+                attributes: filtered,
+                mappings,
+                count: Array.isArray(filtered) ? filtered.length : 0,
+                resource_type: UniversalResourceType.RECORDS,
+                resourceType: 'records',
+                objectSlug,
+            };
+        }
+        catch (error) {
+            throw this.errorService.toStructuredError('records', error);
+        }
+    }
+    async discoverTasksWithMetrics(options) {
+        return this.runner.run({
+            cacheKey: { resourceType: options.resourceType },
+            cacheTtl: options.cacheTtl,
+            useCache: options.useCache,
+            loader: () => this.discoverTasks({
+                categories: options.categories,
+            }),
+            metrics: {
+                resourceType: options.resourceType,
+                objectSlug: options.objectSlug,
+            },
+            onError: (error) => this.errorService.toStructuredError(options.resourceType, error),
+        });
+    }
+    async discoverRecordsWithMetrics(options) {
+        const { objectSlug } = options;
+        if (!objectSlug) {
+            throw new Error('discoverAttributesForResourceType(records) requires objectSlug in options');
+        }
+        return this.runner.run({
+            cacheKey: {
+                resourceType: options.resourceType,
+                objectSlug,
+            },
+            cacheTtl: options.cacheTtl,
+            useCache: options.useCache,
+            loader: () => this.discoverObject({
+                objectSlug,
+                categories: options.categories,
+            }),
+            metrics: {
+                resourceType: options.resourceType,
+                objectSlug,
+            },
+            onError: (error) => this.errorService.toStructuredError('records', error),
+        });
+    }
+    async discoverStandardResource(options) {
+        return this.runner.run({
+            cacheKey: { resourceType: options.resourceType },
+            cacheTtl: options.cacheTtl,
+            useCache: options.useCache,
+            loader: () => this.performAttributeDiscovery(options.resourceType, {
+                categories: options.categories,
+            }),
+            metrics: {
+                resourceType: options.resourceType,
+                objectSlug: options.objectSlug,
+            },
+            onError: (error) => this.errorService.toStructuredError(options.resourceType, error),
+        });
+    }
+    async performAttributeDiscovery(resourceType, options) {
+        const client = getLazyAttioClient();
+        try {
+            const resourceSlug = OBJECT_SLUG_MAP[resourceType.toLowerCase()] ||
+                resourceType.toLowerCase();
+            let path = `/objects/${resourceSlug}/attributes`;
+            if (options?.categories?.length) {
+                const validatedCategories = secureValidateCategories(options.categories, 'category filtering in get-attributes');
+                if (validatedCategories.length > 0) {
+                    path += `?categories=${encodeURIComponent(validatedCategories.join(','))}`;
+                }
+            }
+            const response = await client.get(path);
+            const parsed = this.transformService.parseAttributesResponse(response?.data);
+            const mappings = this.transformService.buildMappings(parsed);
+            return {
+                attributes: parsed,
+                mappings,
+                count: parsed.length,
+                resource_type: resourceType,
+            };
+        }
+        catch (error) {
+            throw this.errorService.toStructuredError(resourceType, error);
+        }
+    }
+}
+//# sourceMappingURL=MetadataDiscoveryService.js.map

package/dist/services/metadata/MetadataDiscoveryService.js.map

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

package/dist/services/metadata/MetadataErrorService.d.ts

@@ -0,0 +1,7 @@
+import type { UniversalResourceType } from '../../handlers/tool-configs/universal/types.js';
+import type { MetadataErrorService } from './types.js';
+export declare class DefaultMetadataErrorService implements MetadataErrorService {
+    toStructuredError(resourceType: UniversalResourceType | string, error: unknown): never;
+    toRecordFetchError(resourceType: UniversalResourceType, recordId: string, error: unknown): never;
+}
+//# sourceMappingURL=MetadataErrorService.d.ts.map

package/dist/services/metadata/MetadataErrorService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MetadataErrorService.d.ts","sourceRoot":"","sources":["../../../src/services/metadata/MetadataErrorService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AAC5F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,qBAAa,2BAA4B,YAAW,oBAAoB;IACtE,iBAAiB,CACf,YAAY,EAAE,qBAAqB,GAAG,MAAM,EAC5C,KAAK,EAAE,OAAO,GACb,KAAK;IAgCR,kBAAkB,CAChB,YAAY,EAAE,qBAAqB,EACnC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,GACb,KAAK;CAcT"}

package/dist/services/metadata/MetadataErrorService.js

@@ -0,0 +1,34 @@
+export class DefaultMetadataErrorService {
+    toStructuredError(resourceType, error) {
+        if (error && typeof error === 'object' && 'response' in error) {
+            const axiosError = error;
+            const status = axiosError.response?.status ?? 500;
+            const message = axiosError.response?.data?.error?.message ??
+                axiosError.response?.data?.message ??
+                axiosError.message ??
+                `API error: ${status}`;
+            throw {
+                status,
+                body: {
+                    code: 'api_error',
+                    message: `Failed to discover ${resourceType} attributes: ${message}`,
+                },
+            };
+        }
+        throw new Error(`Failed to discover ${resourceType} attributes: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    toRecordFetchError(resourceType, recordId, error) {
+        const message = error instanceof Error
+            ? error.message
+            : (() => {
+                try {
+                    return JSON.stringify(error);
+                }
+                catch {
+                    return String(error);
+                }
+            })();
+        throw new Error(`Failed to get record attributes: ${message}`);
+    }
+}
+//# sourceMappingURL=MetadataErrorService.js.map

package/dist/services/metadata/MetadataErrorService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MetadataErrorService.js","sourceRoot":"","sources":["../../../src/services/metadata/MetadataErrorService.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,2BAA2B;IACtC,iBAAiB,CACf,YAA4C,EAC5C,KAAc;QAEd,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,UAAU,IAAI,KAAK,EAAE,CAAC;YAC9D,MAAM,UAAU,GAAG,KAMlB,CAAC;YACF,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,CAAC;YAClD,MAAM,OAAO,GACX,UAAU,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO;gBACzC,UAAU,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO;gBAClC,UAAU,CAAC,OAAO;gBAClB,cAAc,MAAM,EAAE,CAAC;YAEzB,MAAM;gBACJ,MAAM;gBACN,IAAI,EAAE;oBACJ,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE,sBAAsB,YAAY,gBAAgB,OAAO,EAAE;iBACrE;aACF,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,KAAK,CACb,sBAAsB,YAAY,gBAChC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CACvD,EAAE,CACH,CAAC;IACJ,CAAC;IAED,kBAAkB,CAChB,YAAmC,EACnC,QAAgB,EAChB,KAAc;QAEd,MAAM,OAAO,GACX,KAAK,YAAY,KAAK;YACpB,CAAC,CAAC,KAAK,CAAC,OAAO;YACf,CAAC,CAAC,CAAC,GAAG,EAAE;gBACJ,IAAI,CAAC;oBACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;gBAC/B,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;gBACvB,CAAC;YACH,CAAC,CAAC,EAAE,CAAC;QAEX,MAAM,IAAI,KAAK,CAAC,oCAAoC,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;CACF"}

package/dist/services/metadata/MetadataMetricsService.d.ts

@@ -0,0 +1,10 @@
+import type { DiscoveryEvent, DiscoveryMetricsSummary, MetadataMetricsService, MetricsFilter } from './types.js';
+export declare class InMemoryMetadataMetricsService implements MetadataMetricsService {
+    private readonly metrics;
+    private readonly maxEntries;
+    record(event: DiscoveryEvent): void;
+    getMetrics(filter?: MetricsFilter): DiscoveryMetricsSummary;
+    clear(): void;
+    private getResourceTypeBreakdown;
+}
+//# sourceMappingURL=MetadataMetricsService.d.ts.map

package/dist/services/metadata/MetadataMetricsService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MetadataMetricsService.d.ts","sourceRoot":"","sources":["../../../src/services/metadata/MetadataMetricsService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,uBAAuB,EACvB,sBAAsB,EACtB,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,qBAAa,8BAA+B,YAAW,sBAAsB;IAC3E,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IAEnC,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAcnC,UAAU,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,uBAAuB;IAyC3D,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,wBAAwB;CA6BjC"}

package/dist/services/metadata/MetadataMetricsService.js

@@ -0,0 +1,72 @@
+export class InMemoryMetadataMetricsService {
+    metrics = [];
+    maxEntries = 1000;
+    record(event) {
+        const metric = {
+            timestamp: Date.now(),
+            cacheHit: false,
+            attributeCount: 0,
+            ...event,
+        };
+        this.metrics.push(metric);
+        if (this.metrics.length > this.maxEntries) {
+            this.metrics.shift();
+        }
+    }
+    getMetrics(filter) {
+        let filtered = [...this.metrics];
+        if (filter?.resourceType) {
+            filtered = filtered.filter((metric) => metric.resourceType === filter.resourceType);
+        }
+        if (typeof filter?.since === 'number') {
+            filtered = filtered.filter((metric) => metric.timestamp >= filter.since);
+        }
+        if (!filter?.includeErrors) {
+            filtered = filtered.filter((metric) => !metric.error);
+        }
+        const totalRequests = filtered.length;
+        const cacheHits = filtered.filter((metric) => metric.cacheHit).length;
+        const totalDuration = filtered.reduce((sum, metric) => sum + metric.duration, 0);
+        const avgDuration = totalRequests > 0 ? totalDuration / totalRequests : 0;
+        const errors = filtered.filter((metric) => metric.error).length;
+        return {
+            totalRequests,
+            cacheHits,
+            cacheHitRate: totalRequests > 0 ? cacheHits / totalRequests : 0,
+            avgDuration,
+            totalDuration,
+            errors,
+            errorRate: totalRequests > 0 ? errors / totalRequests : 0,
+            slowRequests: filtered.filter((metric) => metric.duration > 3000).length,
+            byResourceType: this.getResourceTypeBreakdown(filtered),
+        };
+    }
+    clear() {
+        this.metrics.length = 0;
+    }
+    getResourceTypeBreakdown(metrics) {
+        const breakdown = {};
+        for (const metric of metrics) {
+            if (!breakdown[metric.resourceType]) {
+                breakdown[metric.resourceType] = {
+                    count: 0,
+                    avgDuration: 0,
+                    cacheHitRate: 0,
+                    errorRate: 0,
+                };
+            }
+            const stats = breakdown[metric.resourceType];
+            stats.count += 1;
+            stats.avgDuration =
+                (stats.avgDuration * (stats.count - 1) + metric.duration) / stats.count;
+            stats.cacheHitRate =
+                (stats.cacheHitRate * (stats.count - 1) + (metric.cacheHit ? 1 : 0)) /
+                    stats.count;
+            stats.errorRate =
+                (stats.errorRate * (stats.count - 1) + (metric.error ? 1 : 0)) /
+                    stats.count;
+        }
+        return breakdown;
+    }
+}
+//# sourceMappingURL=MetadataMetricsService.js.map

package/dist/services/metadata/MetadataMetricsService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MetadataMetricsService.js","sourceRoot":"","sources":["../../../src/services/metadata/MetadataMetricsService.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,8BAA8B;IACxB,OAAO,GAAqB,EAAE,CAAC;IAC/B,UAAU,GAAG,IAAI,CAAC;IAEnC,MAAM,CAAC,KAAqB;QAC1B,MAAM,MAAM,GAAmB;YAC7B,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,QAAQ,EAAE,KAAK;YACf,cAAc,EAAE,CAAC;YACjB,GAAG,KAAK;SACT,CAAC;QAEF,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1B,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YAC1C,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;IACH,CAAC;IAED,UAAU,CAAC,MAAsB;QAC/B,IAAI,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;QAEjC,IAAI,MAAM,EAAE,YAAY,EAAE,CAAC;YACzB,QAAQ,GAAG,QAAQ,CAAC,MAAM,CACxB,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,YAAY,KAAK,MAAM,CAAC,YAAY,CACxD,CAAC;QACJ,CAAC;QAED,IAAI,OAAO,MAAM,EAAE,KAAK,KAAK,QAAQ,EAAE,CAAC;YACtC,QAAQ,GAAG,QAAQ,CAAC,MAAM,CACxB,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,SAAU,IAAI,MAAM,CAAC,KAAM,CAC/C,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC;YAC3B,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACxD,CAAC;QAED,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC;QACtC,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC;QACtE,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CACnC,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,GAAG,GAAG,MAAM,CAAC,QAAQ,EACtC,CAAC,CACF,CAAC;QACF,MAAM,WAAW,GAAG,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1E,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;QAEhE,OAAO;YACL,aAAa;YACb,SAAS;YACT,YAAY,EAAE,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;YAC/D,WAAW;YACX,aAAa;YACb,MAAM;YACN,SAAS,EAAE,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;YACzD,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC,MAAM;YACxE,cAAc,EAAE,IAAI,CAAC,wBAAwB,CAAC,QAAQ,CAAC;SACxD,CAAC;IACJ,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IAC1B,CAAC;IAEO,wBAAwB,CAC9B,OAAyB;QAEzB,MAAM,SAAS,GAA8C,EAAE,CAAC;QAEhE,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;gBACpC,SAAS,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG;oBAC/B,KAAK,EAAE,CAAC;oBACR,WAAW,EAAE,CAAC;oBACd,YAAY,EAAE,CAAC;oBACf,SAAS,EAAE,CAAC;iBACb,CAAC;YACJ,CAAC;YAED,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;YAC7C,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;YACjB,KAAK,CAAC,WAAW;gBACf,CAAC,KAAK,CAAC,WAAW,GAAG,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC;YAC1E,KAAK,CAAC,YAAY;gBAChB,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;oBACpE,KAAK,CAAC,KAAK,CAAC;YACd,KAAK,CAAC,SAAS;gBACb,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;oBAC9D,KAAK,CAAC,KAAK,CAAC;QAChB,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;CACF"}

package/dist/services/metadata/MetadataRecordService.d.ts

@@ -0,0 +1,8 @@
+import type { UniversalResourceType } from '../../handlers/tool-configs/universal/types.js';
+import type { MetadataErrorService, MetadataRecordService } from './types.js';
+export declare class DefaultMetadataRecordService implements MetadataRecordService {
+    private readonly errorService;
+    constructor(errorService: MetadataErrorService);
+    getAttributesForRecord(resourceType: UniversalResourceType, recordId: string): Promise<Record<string, unknown>>;
+}
+//# sourceMappingURL=MetadataRecordService.d.ts.map

package/dist/services/metadata/MetadataRecordService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MetadataRecordService.d.ts","sourceRoot":"","sources":["../../../src/services/metadata/MetadataRecordService.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AAC5F,OAAO,KAAK,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAU9E,qBAAa,4BAA6B,YAAW,qBAAqB;IAC5D,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAAZ,YAAY,EAAE,oBAAoB;IAEzD,sBAAsB,CAC1B,YAAY,EAAE,qBAAqB,EACnC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAiDpC"}

package/dist/services/metadata/MetadataRecordService.js

@@ -0,0 +1,44 @@
+import { getLazyAttioClient } from '../../api/lazy-client.js';
+import { OBJECT_SLUG_MAP } from '../../constants/universal.constants.js';
+import { OperationType as OperationTypeEnum } from '../../utils/logger.js';
+import { createScopedLogger } from '../../utils/logger.js';
+const logger = createScopedLogger('MetadataRecordService', undefined, OperationTypeEnum.DATA_PROCESSING);
+export class DefaultMetadataRecordService {
+    errorService;
+    constructor(errorService) {
+        this.errorService = errorService;
+    }
+    async getAttributesForRecord(resourceType, recordId) {
+        const client = getLazyAttioClient();
+        try {
+            const resourceSlug = OBJECT_SLUG_MAP[resourceType.toLowerCase()] ||
+                resourceType.toLowerCase();
+            const response = await client.get(`/objects/${resourceSlug}/records/${recordId}`);
+            if (!response || !response.data) {
+                throw {
+                    status: 500,
+                    body: {
+                        code: 'invalid_response',
+                        message: `Invalid API response for ${resourceType} record: ${recordId}`,
+                    },
+                };
+            }
+            const result = response.data.data?.values || response.data.data || {};
+            if (result === null || result === undefined) {
+                throw {
+                    status: 404,
+                    body: {
+                        code: 'not_found',
+                        message: `${resourceType} record with ID "${recordId}" not found.`,
+                    },
+                };
+            }
+            return result;
+        }
+        catch (error) {
+            logger.error(`Failed to get attributes for ${resourceType} record ${recordId}`, error, { resourceType, recordId });
+            return this.errorService.toRecordFetchError(resourceType, recordId, error);
+        }
+    }
+}
+//# sourceMappingURL=MetadataRecordService.js.map

package/dist/services/metadata/MetadataRecordService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MetadataRecordService.js","sourceRoot":"","sources":["../../../src/services/metadata/MetadataRecordService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AAGzE,OAAO,EAAE,aAAa,IAAI,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D,MAAM,MAAM,GAAG,kBAAkB,CAC/B,uBAAuB,EACvB,SAAS,EACT,iBAAiB,CAAC,eAAe,CAClC,CAAC;AAEF,MAAM,OAAO,4BAA4B;IACV;IAA7B,YAA6B,YAAkC;QAAlC,iBAAY,GAAZ,YAAY,CAAsB;IAAG,CAAC;IAEnE,KAAK,CAAC,sBAAsB,CAC1B,YAAmC,EACnC,QAAgB;QAEhB,MAAM,MAAM,GAAG,kBAAkB,EAAE,CAAC;QAEpC,IAAI,CAAC;YACH,MAAM,YAAY,GAChB,eAAe,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;gBAC3C,YAAY,CAAC,WAAW,EAAE,CAAC;YAE7B,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAC/B,YAAY,YAAY,YAAY,QAAQ,EAAE,CAC/C,CAAC;YAEF,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;gBAChC,MAAM;oBACJ,MAAM,EAAE,GAAG;oBACX,IAAI,EAAE;wBACJ,IAAI,EAAE,kBAAkB;wBACxB,OAAO,EAAE,4BAA4B,YAAY,YAAY,QAAQ,EAAE;qBACxE;iBACF,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;YAEtE,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC5C,MAAM;oBACJ,MAAM,EAAE,GAAG;oBACX,IAAI,EAAE;wBACJ,IAAI,EAAE,WAAW;wBACjB,OAAO,EAAE,GAAG,YAAY,oBAAoB,QAAQ,cAAc;qBACnE;iBACF,CAAC;YACJ,CAAC;YAED,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,CAAC,KAAK,CACV,gCAAgC,YAAY,WAAW,QAAQ,EAAE,EACjE,KAAK,EACL,EAAE,YAAY,EAAE,QAAQ,EAAE,CAC3B,CAAC;YAEF,OAAO,IAAI,CAAC,YAAY,CAAC,kBAAkB,CACzC,YAAY,EACZ,QAAQ,EACR,KAAK,CACN,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/services/metadata/MetadataTransformService.d.ts

@@ -0,0 +1,7 @@
+import type { MetadataTransformService } from './types.js';
+export declare class DefaultMetadataTransformService implements MetadataTransformService {
+    parseAttributesResponse(data: unknown): unknown[];
+    buildMappings(attributes: unknown[]): Record<string, string>;
+    filterByCategory(attributes: Record<string, unknown> | unknown[], categories?: string[]): Record<string, unknown> | unknown[];
+}
+//# sourceMappingURL=MetadataTransformService.d.ts.map

package/dist/services/metadata/MetadataTransformService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MetadataTransformService.d.ts","sourceRoot":"","sources":["../../../src/services/metadata/MetadataTransformService.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAI3D,qBAAa,+BACX,YAAW,wBAAwB;IAEnC,uBAAuB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,EAAE;IA2CjD,aAAa,CAAC,UAAU,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAU5D,gBAAgB,CACd,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,EAAE,EAC/C,UAAU,CAAC,EAAE,MAAM,EAAE,GACpB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,EAAE;CAmDvC"}

package/dist/services/metadata/MetadataTransformService.js

@@ -0,0 +1,87 @@
+import { debug, OperationType } from '../../utils/logger.js';
+import { isAttioAttribute } from '../../types/service-types.js';
+const LOGGER_SCOPE = 'MetadataTransformService';
+export class DefaultMetadataTransformService {
+    parseAttributesResponse(data) {
+        if (Array.isArray(data))
+            return data;
+        if (data && typeof data === 'object') {
+            const obj = data;
+            const dataArr = obj.data;
+            if (Array.isArray(dataArr))
+                return dataArr;
+            const attrs = obj.attributes;
+            if (Array.isArray(attrs))
+                return attrs;
+            const merged = [];
+            const all = obj.all;
+            const custom = obj.custom;
+            const standard = obj.standard;
+            if (Array.isArray(all))
+                merged.push(...all);
+            if (Array.isArray(custom))
+                merged.push(...custom);
+            if (Array.isArray(standard))
+                merged.push(...standard);
+            if (merged.length > 0) {
+                return merged;
+            }
+        }
+        if (process.env.E2E_MODE === 'true') {
+            debug(LOGGER_SCOPE, 'Unrecognized attribute response shape, returning empty array', {
+                receivedKeys: data && typeof data === 'object'
+                    ? Object.keys(data)
+                    : typeof data,
+            }, 'parseAttributesResponse', OperationType.DATA_PROCESSING);
+        }
+        return [];
+    }
+    buildMappings(attributes) {
+        const mappings = {};
+        attributes.forEach((attribute) => {
+            if (isAttioAttribute(attribute)) {
+                mappings[attribute.title] = attribute.api_slug;
+            }
+        });
+        return mappings;
+    }
+    filterByCategory(attributes, categories) {
+        if (!categories || categories.length === 0) {
+            return attributes;
+        }
+        if (Array.isArray(attributes)) {
+            const filtered = attributes.filter((attr) => {
+                if (typeof attr !== 'object' || attr === null) {
+                    return false;
+                }
+                const attributeRecord = attr;
+                const category = attributeRecord.category ??
+                    attributeRecord.type ??
+                    attributeRecord.attribute_type ??
+                    attributeRecord.group;
+                return typeof category === 'string' && categories.includes(category);
+            });
+            return filtered;
+        }
+        if (typeof attributes === 'object' && attributes !== null) {
+            const attributeRecord = attributes;
+            if (Array.isArray(attributeRecord.attributes)) {
+                const filtered = this.filterByCategory(attributeRecord.attributes, categories);
+                return {
+                    ...attributeRecord,
+                    attributes: filtered,
+                    count: Array.isArray(filtered) ? filtered.length : 0,
+                };
+            }
+            if (Array.isArray(attributeRecord.all)) {
+                const filtered = this.filterByCategory(attributeRecord.all, categories);
+                return {
+                    attributes: filtered,
+                    count: Array.isArray(filtered) ? filtered.length : 0,
+                };
+            }
+        }
+        return attributes;
+    }
+}
+//# sourceMappingURL=MetadataTransformService.js.map

package/dist/services/metadata/MetadataTransformService.js.map

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

package/dist/services/metadata/discovery-runner.d.ts

@@ -0,0 +1,25 @@
+import type { UniversalResourceType } from '../../handlers/tool-configs/universal/types.js';
+import type { MetadataCacheKey, MetadataCacheService, MetadataMetricsService, MetadataResult } from './types.js';
+interface DiscoveryMetricsContext {
+    resourceType: UniversalResourceType;
+    objectSlug?: string;
+}
+interface DiscoveryTask {
+    cacheKey: MetadataCacheKey;
+    cacheTtl?: number;
+    useCache?: boolean;
+    loader: () => Promise<MetadataResult>;
+    metrics: DiscoveryMetricsContext;
+    onError: (error: unknown) => never;
+}
+export declare class DiscoveryRunner {
+    private readonly cacheService;
+    private readonly metricsService;
+    constructor(cacheService: MetadataCacheService, metricsService: MetadataMetricsService);
+    run(task: DiscoveryTask): Promise<MetadataResult>;
+    private load;
+    private recordMetrics;
+    private formatError;
+}
+export {};
+//# sourceMappingURL=discovery-runner.d.ts.map

package/dist/services/metadata/discovery-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery-runner.d.ts","sourceRoot":"","sources":["../../../src/services/metadata/discovery-runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AACxF,OAAO,KAAK,EAEV,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,EACtB,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB,UAAU,uBAAuB;IAC/B,YAAY,EAAE,qBAAqB,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,aAAa;IACrB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;IACtC,OAAO,EAAE,uBAAuB,CAAC;IACjC,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,CAAC;CACpC;AAED,qBAAa,eAAe;IAExB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,cAAc;gBADd,YAAY,EAAE,oBAAoB,EAClC,cAAc,EAAE,sBAAsB;IAGnD,GAAG,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;YAwBzC,IAAI;IAiBlB,OAAO,CAAC,aAAa;IA6BrB,OAAO,CAAC,WAAW;CAWpB"}

package/dist/services/metadata/discovery-runner.js

@@ -0,0 +1,66 @@
+export class DiscoveryRunner {
+    cacheService;
+    metricsService;
+    constructor(cacheService, metricsService) {
+        this.cacheService = cacheService;
+        this.metricsService = metricsService;
+    }
+    async run(task) {
+        const startTime = Date.now();
+        try {
+            const result = await this.load(task);
+            this.recordMetrics({
+                ...task.metrics,
+                duration: Date.now() - startTime,
+                cacheHit: result.fromCache,
+                result: result.data,
+            });
+            return result.data;
+        }
+        catch (error) {
+            this.recordMetrics({
+                ...task.metrics,
+                duration: Date.now() - startTime,
+                cacheHit: false,
+                result: { attributes: [] },
+                error,
+            });
+            task.onError(error);
+        }
+    }
+    async load({ cacheKey, cacheTtl, useCache = true, loader, }) {
+        if (useCache) {
+            return this.cacheService.getOrLoad(cacheKey, loader, cacheTtl);
+        }
+        const data = await loader();
+        return {
+            data,
+            fromCache: false,
+        };
+    }
+    recordMetrics({ resourceType, objectSlug, duration, cacheHit, result, error, }) {
+        const attributeCount = Array.isArray(result?.attributes)
+            ? result.attributes.length
+            : 0;
+        this.metricsService.record({
+            resourceType,
+            objectSlug,
+            duration,
+            cacheHit,
+            attributeCount,
+            error: error ? this.formatError(error) : undefined,
+        });
+    }
+    formatError(error) {
+        if (error instanceof Error) {
+            return error.message;
+        }
+        try {
+            return JSON.stringify(error);
+        }
+        catch {
+            return String(error);
+        }
+    }
+}
+//# sourceMappingURL=discovery-runner.js.map

package/dist/services/metadata/discovery-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery-runner.js","sourceRoot":"","sources":["../../../src/services/metadata/discovery-runner.ts"],"names":[],"mappings":"AAuBA,MAAM,OAAO,eAAe;IAEP;IACA;IAFnB,YACmB,YAAkC,EAClC,cAAsC;QADtC,iBAAY,GAAZ,YAAY,CAAsB;QAClC,mBAAc,GAAd,cAAc,CAAwB;IACtD,CAAC;IAEJ,KAAK,CAAC,GAAG,CAAC,IAAmB;QAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrC,IAAI,CAAC,aAAa,CAAC;gBACjB,GAAG,IAAI,CAAC,OAAO;gBACf,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;gBAChC,QAAQ,EAAE,MAAM,CAAC,SAAS;gBAC1B,MAAM,EAAE,MAAM,CAAC,IAAI;aACpB,CAAC,CAAC;YACH,OAAO,MAAM,CAAC,IAAI,CAAC;QACrB,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,CAAC,aAAa,CAAC;gBACjB,GAAG,IAAI,CAAC,OAAO;gBACf,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;gBAChC,QAAQ,EAAE,KAAK;gBACf,MAAM,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;gBAC1B,KAAK;aACN,CAAC,CAAC;YACH,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,IAAI,CAAC,EACjB,QAAQ,EACR,QAAQ,EACR,QAAQ,GAAG,IAAI,EACf,MAAM,GACQ;QACd,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;QACjE,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,MAAM,EAAE,CAAC;QAC5B,OAAO;YACL,IAAI;YACJ,SAAS,EAAE,KAAK;SACjB,CAAC;IACJ,CAAC;IAEO,aAAa,CAAC,EACpB,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,KAAK,GAQN;QACC,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC;YACtD,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM;YAC1B,CAAC,CAAC,CAAC,CAAC;QAEN,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC;YACzB,YAAY;YACZ,UAAU;YACV,QAAQ;YACR,QAAQ;YACR,cAAc;YACd,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;SACnD,CAAC,CAAC;IACL,CAAC;IAEO,WAAW,CAAC,KAAc;QAChC,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,OAAO,KAAK,CAAC,OAAO,CAAC;QACvB,CAAC;QAED,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;CACF"}

package/dist/services/metadata/index.d.ts

@@ -0,0 +1,11 @@
+import type { MetadataServicesDeps } from './types.js';
+export declare function createDefaultMetadataServices(): MetadataServicesDeps;
+export * from './types.js';
+export { DefaultMetadataCacheService } from './MetadataCacheService.js';
+export { DefaultMetadataDiscoveryService } from './MetadataDiscoveryService.js';
+export { DefaultMetadataErrorService } from './MetadataErrorService.js';
+export { InMemoryMetadataMetricsService } from './MetadataMetricsService.js';
+export { DefaultMetadataRecordService } from './MetadataRecordService.js';
+export { DefaultMetadataTransformService } from './MetadataTransformService.js';
+export { AttributeOptionsService, type AttributeOptionsResult, } from './AttributeOptionsService.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/metadata/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/metadata/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,wBAAgB,6BAA6B,IAAI,oBAAoB,CAoBpE;AAED,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,+BAA+B,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAC;AAC7E,OAAO,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,EAAE,+BAA+B,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,EACL,uBAAuB,EACvB,KAAK,sBAAsB,GAC5B,MAAM,8BAA8B,CAAC"}

package/dist/services/metadata/index.js

@@ -0,0 +1,30 @@
+import { DefaultMetadataCacheService } from './MetadataCacheService.js';
+import { DefaultMetadataDiscoveryService } from './MetadataDiscoveryService.js';
+import { DefaultMetadataErrorService } from './MetadataErrorService.js';
+import { InMemoryMetadataMetricsService } from './MetadataMetricsService.js';
+import { DefaultMetadataRecordService } from './MetadataRecordService.js';
+import { DefaultMetadataTransformService } from './MetadataTransformService.js';
+export function createDefaultMetadataServices() {
+    const errorService = new DefaultMetadataErrorService();
+    const metricsService = new InMemoryMetadataMetricsService();
+    const cacheService = new DefaultMetadataCacheService();
+    const transformService = new DefaultMetadataTransformService();
+    const discoveryService = new DefaultMetadataDiscoveryService(cacheService, metricsService, transformService, errorService);
+    const recordService = new DefaultMetadataRecordService(errorService);
+    return {
+        cacheService,
+        discoveryService,
+        recordService,
+        transformService,
+        metricsService,
+    };
+}
+export * from './types.js';
+export { DefaultMetadataCacheService } from './MetadataCacheService.js';
+export { DefaultMetadataDiscoveryService } from './MetadataDiscoveryService.js';
+export { DefaultMetadataErrorService } from './MetadataErrorService.js';
+export { InMemoryMetadataMetricsService } from './MetadataMetricsService.js';
+export { DefaultMetadataRecordService } from './MetadataRecordService.js';
+export { DefaultMetadataTransformService } from './MetadataTransformService.js';
+export { AttributeOptionsService, } from './AttributeOptionsService.js';
+//# sourceMappingURL=index.js.map

package/dist/services/metadata/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/metadata/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,+BAA+B,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAC;AAC7E,OAAO,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,EAAE,+BAA+B,EAAE,MAAM,+BAA+B,CAAC;AAGhF,MAAM,UAAU,6BAA6B;IAC3C,MAAM,YAAY,GAAG,IAAI,2BAA2B,EAAE,CAAC;IACvD,MAAM,cAAc,GAAG,IAAI,8BAA8B,EAAE,CAAC;IAC5D,MAAM,YAAY,GAAG,IAAI,2BAA2B,EAAE,CAAC;IACvD,MAAM,gBAAgB,GAAG,IAAI,+BAA+B,EAAE,CAAC;IAC/D,MAAM,gBAAgB,GAAG,IAAI,+BAA+B,CAC1D,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,YAAY,CACb,CAAC;IACF,MAAM,aAAa,GAAG,IAAI,4BAA4B,CAAC,YAAY,CAAC,CAAC;IAErE,OAAO;QACL,YAAY;QACZ,gBAAgB;QAChB,aAAa;QACb,gBAAgB;QAChB,cAAc;KACf,CAAC;AACJ,CAAC;AAED,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,+BAA+B,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAC;AAC7E,OAAO,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,EAAE,+BAA+B,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,EACL,uBAAuB,GAExB,MAAM,8BAA8B,CAAC"}