attio-mcp 0.1.2 → 1.1.0

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":"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"}

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,10 @@
+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';
+//# 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"}

package/dist/services/metadata/index.js

@@ -0,0 +1,29 @@
+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';
+//# 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"}

package/dist/services/metadata/task-metadata.d.ts

@@ -0,0 +1,13 @@
+import type { MetadataResult, MetadataTransformService } from './types.js';
+declare const TASK_ATTRIBUTE_DEFINITIONS: {
+    id: string;
+    api_slug: string;
+    title: string;
+    type: string;
+    category: string;
+    description: string;
+    required: boolean;
+}[];
+export declare function buildTaskMetadata(transformService: MetadataTransformService, categories?: string[]): MetadataResult;
+export { TASK_ATTRIBUTE_DEFINITIONS };
+//# sourceMappingURL=task-metadata.d.ts.map

package/dist/services/metadata/task-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-metadata.d.ts","sourceRoot":"","sources":["../../../src/services/metadata/task-metadata.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAE3E,QAAA,MAAM,0BAA0B;;;;;;;;GAuD/B,CAAC;AAWF,wBAAgB,iBAAiB,CAC/B,gBAAgB,EAAE,wBAAwB,EAC1C,UAAU,CAAC,EAAE,MAAM,EAAE,GACpB,cAAc,CAsBhB;AAED,OAAO,EAAE,0BAA0B,EAAE,CAAC"}

package/dist/services/metadata/task-metadata.js

@@ -0,0 +1,84 @@
+import { UniversalResourceType } from '../../handlers/tool-configs/universal/types.js';
+const TASK_ATTRIBUTE_DEFINITIONS = [
+    {
+        id: 'content',
+        api_slug: 'content',
+        title: 'Content',
+        type: 'text',
+        category: 'basic',
+        description: 'The main text/description of the task',
+        required: true,
+    },
+    {
+        id: 'status',
+        api_slug: 'status',
+        title: 'Status',
+        type: 'text',
+        category: 'basic',
+        description: 'Task completion status (e.g., pending, completed)',
+        required: false,
+    },
+    {
+        id: 'assignee',
+        api_slug: 'assignee',
+        title: 'Assignee',
+        type: 'person-reference',
+        category: 'business',
+        description: 'Person assigned to this task',
+        required: false,
+    },
+    {
+        id: 'assignee_id',
+        api_slug: 'assignee_id',
+        title: 'Assignee ID',
+        type: 'text',
+        category: 'business',
+        description: 'ID of the workspace member assigned to this task',
+        required: false,
+    },
+    {
+        id: 'due_date',
+        api_slug: 'due_date',
+        title: 'Due Date',
+        type: 'date',
+        category: 'basic',
+        description: 'When the task is due (ISO date format)',
+        required: false,
+    },
+    {
+        id: 'linked_records',
+        api_slug: 'linked_records',
+        title: 'Linked Records',
+        type: 'record-reference',
+        category: 'business',
+        description: 'Records this task is associated with',
+        required: false,
+    },
+];
+const TASK_MAPPING_SYNONYMS = {
+    title: 'content',
+    name: 'content',
+    description: 'content',
+    assignee: 'assignee_id',
+    due: 'due_date',
+    record: 'linked_records',
+};
+export function buildTaskMetadata(transformService, categories) {
+    const filtered = categories?.length
+        ? transformService.filterByCategory(TASK_ATTRIBUTE_DEFINITIONS, categories)
+        : TASK_ATTRIBUTE_DEFINITIONS;
+    const mappings = transformService.buildMappings(filtered);
+    for (const [displayName, apiField] of Object.entries(TASK_MAPPING_SYNONYMS)) {
+        mappings[displayName] = apiField;
+    }
+    return {
+        attributes: filtered,
+        mappings,
+        count: Array.isArray(filtered) ? filtered.length : 0,
+        resource_type: UniversalResourceType.TASKS,
+        api_endpoint: '/tasks',
+        supports_objects_api: false,
+    };
+}
+export { TASK_ATTRIBUTE_DEFINITIONS };
+//# sourceMappingURL=task-metadata.js.map

package/dist/services/metadata/task-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-metadata.js","sourceRoot":"","sources":["../../../src/services/metadata/task-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AAGnF,MAAM,0BAA0B,GAAG;IACjC;QACE,EAAE,EAAE,SAAS;QACb,QAAQ,EAAE,SAAS;QACnB,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,OAAO;QACjB,WAAW,EAAE,uCAAuC;QACpD,QAAQ,EAAE,IAAI;KACf;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,QAAQ,EAAE,QAAQ;QAClB,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,OAAO;QACjB,WAAW,EAAE,mDAAmD;QAChE,QAAQ,EAAE,KAAK;KAChB;IACD;QACE,EAAE,EAAE,UAAU;QACd,QAAQ,EAAE,UAAU;QACpB,KAAK,EAAE,UAAU;QACjB,IAAI,EAAE,kBAAkB;QACxB,QAAQ,EAAE,UAAU;QACpB,WAAW,EAAE,8BAA8B;QAC3C,QAAQ,EAAE,KAAK;KAChB;IACD;QACE,EAAE,EAAE,aAAa;QACjB,QAAQ,EAAE,aAAa;QACvB,KAAK,EAAE,aAAa;QACpB,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,UAAU;QACpB,WAAW,EAAE,kDAAkD;QAC/D,QAAQ,EAAE,KAAK;KAChB;IACD;QACE,EAAE,EAAE,UAAU;QACd,QAAQ,EAAE,UAAU;QACpB,KAAK,EAAE,UAAU;QACjB,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,OAAO;QACjB,WAAW,EAAE,wCAAwC;QACrD,QAAQ,EAAE,KAAK;KAChB;IACD;QACE,EAAE,EAAE,gBAAgB;QACpB,QAAQ,EAAE,gBAAgB;QAC1B,KAAK,EAAE,gBAAgB;QACvB,IAAI,EAAE,kBAAkB;QACxB,QAAQ,EAAE,UAAU;QACpB,WAAW,EAAE,sCAAsC;QACnD,QAAQ,EAAE,KAAK;KAChB;CACF,CAAC;AAEF,MAAM,qBAAqB,GAA2B;IACpD,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,SAAS;IACtB,QAAQ,EAAE,aAAa;IACvB,GAAG,EAAE,UAAU;IACf,MAAM,EAAE,gBAAgB;CACzB,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAC/B,gBAA0C,EAC1C,UAAqB;IAErB,MAAM,QAAQ,GAAG,UAAU,EAAE,MAAM;QACjC,CAAC,CAAE,gBAAgB,CAAC,gBAAgB,CAChC,0BAA0B,EAC1B,UAAU,CACG;QACjB,CAAC,CAAC,0BAA0B,CAAC;IAE/B,MAAM,QAAQ,GAAG,gBAAgB,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAE1D,KAAK,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,qBAAqB,CAAC,EAAE,CAAC;QAC5E,QAAQ,CAAC,WAAW,CAAC,GAAG,QAAQ,CAAC;IACnC,CAAC;IAED,OAAO;QACL,UAAU,EAAE,QAAQ;QACpB,QAAQ;QACR,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACpD,aAAa,EAAE,qBAAqB,CAAC,KAAK;QAC1C,YAAY,EAAE,QAAQ;QACtB,oBAAoB,EAAE,KAAK;KAC5B,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,0BAA0B,EAAE,CAAC"}

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

@@ -0,0 +1,95 @@
+import type { UniversalResourceType } from '../../handlers/tool-configs/universal/types.js';
+export interface MetadataResult extends Record<string, unknown> {
+    attributes?: unknown[];
+    mappings?: Record<string, string>;
+    count?: number;
+    resource_type?: UniversalResourceType | string;
+    objectSlug?: string;
+}
+export interface DiscoverTypeOptions {
+    resourceType: UniversalResourceType;
+    categories?: string[];
+    objectSlug?: string;
+    useCache?: boolean;
+    cacheTtl?: number;
+}
+export interface DiscoverTaskOptions {
+    categories?: string[];
+}
+export interface DiscoverObjectOptions {
+    objectSlug: string;
+    categories?: string[];
+    useCache?: boolean;
+    cacheTtl?: number;
+}
+export interface MetadataCacheKey {
+    resourceType: UniversalResourceType;
+    objectSlug?: string;
+}
+export interface CachedMetadataResult {
+    data: MetadataResult;
+    fromCache: boolean;
+}
+export interface DiscoveryEvent {
+    timestamp?: number;
+    resourceType: string;
+    duration: number;
+    cacheHit?: boolean;
+    attributeCount?: number;
+    objectSlug?: string;
+    error?: string;
+}
+export interface MetricsFilter {
+    resourceType?: string;
+    since?: number;
+    includeErrors?: boolean;
+}
+export interface DiscoveryMetricsSummary {
+    totalRequests: number;
+    cacheHits: number;
+    cacheHitRate: number;
+    avgDuration: number;
+    totalDuration: number;
+    errors: number;
+    errorRate: number;
+    slowRequests: number;
+    byResourceType: Record<string, {
+        count: number;
+        avgDuration: number;
+        cacheHitRate: number;
+        errorRate: number;
+    }>;
+}
+export interface MetadataServicesDeps {
+    cacheService: MetadataCacheService;
+    discoveryService: MetadataDiscoveryService;
+    recordService: MetadataRecordService;
+    transformService: MetadataTransformService;
+    metricsService: MetadataMetricsService;
+}
+export interface MetadataCacheService {
+    getOrLoad(key: MetadataCacheKey, loader: () => Promise<MetadataResult>, ttl?: number): Promise<CachedMetadataResult>;
+}
+export interface MetadataMetricsService {
+    record(event: DiscoveryEvent): void;
+    getMetrics(filter?: MetricsFilter): DiscoveryMetricsSummary;
+    clear(): void;
+}
+export interface MetadataTransformService {
+    parseAttributesResponse(data: unknown): unknown[];
+    buildMappings(attributes: unknown[]): Record<string, string>;
+    filterByCategory(attributes: Record<string, unknown> | unknown[], categories?: string[]): Record<string, unknown> | unknown[];
+}
+export interface MetadataDiscoveryService {
+    discoverForType(options: DiscoverTypeOptions): Promise<MetadataResult>;
+    discoverTasks(options?: DiscoverTaskOptions): Promise<MetadataResult>;
+    discoverObject(options: DiscoverObjectOptions): Promise<MetadataResult>;
+}
+export interface MetadataRecordService {
+    getAttributesForRecord(resourceType: UniversalResourceType, recordId: string): Promise<Record<string, unknown>>;
+}
+export interface MetadataErrorService {
+    toStructuredError(resourceType: UniversalResourceType | string, error: unknown): never;
+    toRecordFetchError(resourceType: UniversalResourceType, recordId: string, error: unknown): never;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/services/metadata/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/metadata/types.ts"],"names":[],"mappings":""}

package/dist/services/normalizers/AttributeAwareNormalizer.d.ts

@@ -0,0 +1,2 @@
+export declare function normalizeValues(resourceType: string, values: Record<string, unknown>, _attributes?: string[]): Promise<Record<string, unknown>>;
+//# sourceMappingURL=AttributeAwareNormalizer.d.ts.map

package/dist/services/normalizers/AttributeAwareNormalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AttributeAwareNormalizer.d.ts","sourceRoot":"","sources":["../../../src/services/normalizers/AttributeAwareNormalizer.ts"],"names":[],"mappings":"AAmJA,wBAAsB,eAAe,CACnC,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,WAAW,CAAC,EAAE,MAAM,EAAE,oCAsCvB"}