attio-mcp 0.1.2 → 1.1.0

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

@@ -0,0 +1,199 @@
+import { getAttributesSchema, discoverAttributesSchema, validateUniversalToolParams, } from '../schemas.js';
+import { handleUniversalGetAttributes, handleUniversalDiscoverAttributes, getSingularResourceType, } from '../shared-handlers.js';
+import { formatToolDescription } from '../../../../handlers/tools/standards/index.js';
+export const getAttributesConfig = {
+    name: 'records_get_attributes',
+    handler: async (params) => {
+        try {
+            const sanitizedParams = validateUniversalToolParams('records_get_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 = args[0];
+        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: 'records_discover_attributes',
+    handler: async (params) => {
+        try {
+            const sanitizedParams = validateUniversalToolParams('records_discover_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 = args[0];
+        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: 'records_get_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: 'records_discover_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: 'Follow with records.get_attributes to inspect specific fields.',
+    }),
+    inputSchema: discoverAttributesSchema,
+    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,83 @@
+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";
+                enum: import("../../../../handlers/tool-configs/universal/types.js").UniversalResourceType[];
+                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,CA6DxB,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,115 @@
+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';
+        }
+    },
+};
+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"}