attio-mcp 0.1.0

package/dist/types/tool-types.d.ts

@@ -0,0 +1,262 @@
+/**
+ * TypeScript interfaces for tool dispatcher and handler operations
+ * Replaces explicit any types with proper interfaces
+ */
+/**
+ * Generic tool request arguments interface
+ */
+export interface ToolRequestArguments {
+    [key: string]: unknown;
+}
+/**
+ * Tool execution request context
+ */
+export interface ToolExecutionRequest {
+    params: {
+        arguments: ToolRequestArguments;
+        name: string;
+    };
+}
+/**
+ * Tool execution error context for logging
+ */
+export interface ToolErrorContext {
+    [key: string]: unknown;
+}
+/**
+ * Attribute validation parameters
+ */
+export interface AttributeValidationParams {
+    [key: string]: unknown;
+}
+/**
+ * Company operation response data
+ */
+export interface CompanyOperationResponse {
+    operation: string;
+    companyId: string;
+    status: 'success' | 'error';
+    data?: unknown;
+    message?: string;
+    timestamp: string;
+}
+/**
+ * Person operation response data
+ */
+export interface PersonOperationResponse {
+    operation: string;
+    personId: string;
+    status: 'success' | 'error';
+    data?: unknown;
+    message?: string;
+    timestamp: string;
+}
+/**
+ * Generic API operation result
+ */
+export interface ApiOperationResult<T = unknown> {
+    success: boolean;
+    data?: T;
+    error?: {
+        message: string;
+        code?: string | number;
+        details?: unknown;
+    };
+}
+/**
+ * Tool configuration registry entry
+ */
+export interface ToolConfig {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+    handler: (args: ToolRequestArguments) => Promise<ApiOperationResult>;
+}
+/**
+ * Batch operation request item
+ */
+export interface BatchOperationItem<T = unknown> {
+    id?: string;
+    params: T;
+}
+/**
+ * Batch operation result item
+ */
+export interface BatchOperationResult<T = unknown> {
+    id?: string;
+    success: boolean;
+    data?: T;
+    error?: {
+        message: string;
+        code?: string | number;
+        details?: unknown;
+    };
+}
+/**
+ * Company creation attributes
+ */
+export interface CompanyCreateAttributes {
+    name: string;
+    website?: string;
+    industry?: string;
+    description?: string;
+    [key: string]: unknown;
+}
+/**
+ * Company update attributes
+ */
+export interface CompanyUpdateAttributes {
+    name?: string;
+    website?: string;
+    industry?: string;
+    description?: string;
+    [key: string]: unknown;
+}
+/**
+ * Person creation attributes
+ */
+export interface PersonCreateAttributes {
+    name?: string;
+    email_addresses?: string[];
+    phone_numbers?: string[];
+    job_title?: string;
+    company?: string;
+    [key: string]: unknown;
+}
+/**
+ * Person update attributes
+ */
+export interface PersonUpdateAttributes {
+    name?: string;
+    email_addresses?: string[];
+    phone_numbers?: string[];
+    job_title?: string;
+    company?: string;
+    [key: string]: unknown;
+}
+/**
+ * Search filter parameters
+ */
+export interface SearchFilterParams {
+    filters: Array<{
+        attribute: {
+            slug: string;
+        };
+        condition: string;
+        value: unknown;
+    }>;
+    matchAny?: boolean;
+}
+/**
+ * List filter parameters
+ */
+export interface ListFilterParams {
+    attributeSlug: string;
+    condition: string;
+    value: unknown;
+}
+/**
+ * Advanced filter parameters
+ */
+export interface AdvancedFilterParams {
+    filters: SearchFilterParams;
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Note creation parameters
+ */
+export interface NoteCreateParams {
+    content: string;
+    title?: string;
+    companyId?: string;
+    personId?: string;
+    uri?: string;
+}
+/**
+ * Task creation parameters
+ */
+export interface TaskCreateParams {
+    content: string;
+    status?: string;
+    assignee?: string;
+    due_date?: string;
+    linked_records?: Array<{
+        id: string;
+        object_slug?: string;
+    }>;
+}
+/**
+ * JSON serialization options
+ */
+export interface JsonSerializationOptions {
+    includeUndefined?: boolean;
+    includeNulls?: boolean;
+    maxDepth?: number;
+}
+/**
+ * Error response structure
+ */
+export interface ErrorResponse {
+    error: string;
+    message: string;
+    details?: unknown;
+    code?: string | number;
+}
+/**
+ * Success response structure
+ */
+export interface SuccessResponse<T = unknown> {
+    success: true;
+    data: T;
+    message?: string;
+}
+/**
+ * Generic API response
+ */
+export type ApiResponse<T = unknown> = SuccessResponse<T> | ErrorResponse;
+/**
+ * Validation result
+ */
+export type ValidationResult = true | string;
+/**
+ * Filter condition value types
+ */
+export type FilterValue = string | number | boolean | null | Array<string | number> | Record<string, unknown>;
+/**
+ * Attribute value types for Attio records
+ */
+export type AttributeValue = string | number | boolean | null | Array<{
+    value: unknown;
+}> | Record<string, unknown>;
+/**
+ * Company field input value types
+ */
+export type CompanyFieldValue = string | number | boolean | null | undefined | Array<unknown> | Record<string, unknown>;
+/**
+ * Processed company field value types
+ */
+export type ProcessedFieldValue = string | number | boolean | null | undefined | Array<string | number | boolean>;
+/**
+ * Contact information value interface
+ */
+export interface ContactValue {
+    email_address?: string;
+    phone_number?: string;
+    value?: string;
+    [key: string]: unknown;
+}
+/**
+ * Note interface for displaying notes
+ */
+export interface NoteDisplay {
+    title?: string;
+    content?: string;
+    timestamp?: string;
+    [key: string]: unknown;
+}
+//# sourceMappingURL=tool-types.d.ts.map

package/dist/types/tool-types.d.ts.map

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

package/dist/types/tool-types.js

@@ -0,0 +1,6 @@
+/**
+ * TypeScript interfaces for tool dispatcher and handler operations
+ * Replaces explicit any types with proper interfaces
+ */
+export {};
+//# sourceMappingURL=tool-types.js.map

package/dist/types/tool-types.js.map

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

package/dist/utils/api-fallback.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Utility functions for API fallback patterns
+ */
+import type { AttioListEntry } from '../types/attio.js';
+import type { ListEntryFilters } from '../api/operations/index.js';
+export interface FallbackOptions {
+    listId: string;
+    filters?: ListEntryFilters;
+    limit?: number;
+    offset?: number;
+}
+export interface ApiClient {
+    post<T>(path: string, body: Record<string, unknown>): Promise<{
+        data: T;
+    }>;
+    get<T>(path: string): Promise<{
+        data: T;
+    }>;
+}
+export interface FallbackLogger {
+    (message: string, context?: Record<string, unknown>, isError?: boolean): void;
+}
+/**
+ * Executes API calls with automatic fallback strategy for list operations
+ *
+ * Strategy:
+ * 1. Try primary endpoint
+ * 2. Try fallback POST endpoint with global query
+ * 3. Try GET endpoint (only if no filters provided)
+ *
+ * @param api - API client instance
+ * @param options - Fallback options
+ * @param createRequestBody - Function to create request body
+ * @param processEntries - Function to process response entries
+ * @param logger - Logging function
+ * @returns Processed list entries
+ */
+export declare function executeWithListFallback<T>(api: ApiClient, options: FallbackOptions, createRequestBody: () => Record<string, unknown>, processEntries: (entries: AttioListEntry[]) => T[], logger: FallbackLogger): Promise<T[]>;
+//# sourceMappingURL=api-fallback.d.ts.map

package/dist/utils/api-fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-fallback.d.ts","sourceRoot":"","sources":["../../src/utils/api-fallback.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAqB,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC,CAAC;IAC3E,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,cAAc;IAC7B,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC/E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,uBAAuB,CAAC,CAAC,EAC7C,GAAG,EAAE,SAAS,EACd,OAAO,EAAE,eAAe,EACxB,iBAAiB,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChD,cAAc,EAAE,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,EAClD,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,CAAC,EAAE,CAAC,CAsHd"}

package/dist/utils/api-fallback.js

@@ -0,0 +1,94 @@
+/**
+ * Executes API calls with automatic fallback strategy for list operations
+ *
+ * Strategy:
+ * 1. Try primary endpoint
+ * 2. Try fallback POST endpoint with global query
+ * 3. Try GET endpoint (only if no filters provided)
+ *
+ * @param api - API client instance
+ * @param options - Fallback options
+ * @param createRequestBody - Function to create request body
+ * @param processEntries - Function to process response entries
+ * @param logger - Logging function
+ * @returns Processed list entries
+ */
+export async function executeWithListFallback(api, options, createRequestBody, processEntries, logger) {
+    const { listId, filters, limit: safeLimit, offset: safeOffset } = options;
+    // Primary endpoint attempt
+    try {
+        const path = `/lists/${listId}/entries/query`;
+        const requestBody = createRequestBody();
+        logger('Primary endpoint attempt', {
+            path,
+            requestBody: JSON.stringify(requestBody),
+        });
+        const response = await api.post(path, requestBody);
+        logger('Primary endpoint successful', {
+            resultCount: response.data.data?.length || 0,
+        });
+        return processEntries(response.data.data || []);
+    }
+    catch (primaryError) {
+        const err = primaryError;
+        logger('Primary endpoint failed', {
+            error: err.message,
+            status: err.response?.status,
+        }, true);
+        // Fallback endpoint attempt
+        try {
+            const fallbackPath = '/lists-entries/query';
+            const fallbackBody = {
+                ...createRequestBody(),
+                list_id: listId,
+            };
+            logger('Fallback endpoint attempt', {
+                path: fallbackPath,
+                requestBody: JSON.stringify(fallbackBody),
+            });
+            const response = await api.post(fallbackPath, fallbackBody);
+            logger('Fallback endpoint successful', {
+                resultCount: response.data.data?.length || 0,
+            });
+            return processEntries(response.data.data || []);
+        }
+        catch (fallbackError) {
+            const err = fallbackError;
+            logger('Fallback endpoint failed', {
+                error: err.message,
+                status: err.response?.status,
+            }, true);
+            // GET endpoint as last resort (only if no filters)
+            if (!filters || !filters.filters || filters.filters.length === 0) {
+                try {
+                    const params = new URLSearchParams();
+                    params.append('list_id', listId);
+                    params.append('expand', 'record');
+                    params.append('limit', (safeLimit || 20).toString());
+                    params.append('offset', (safeOffset || 0).toString());
+                    const getPath = `/lists-entries?${params.toString()}`;
+                    logger('GET fallback attempt', { path: getPath });
+                    const response = await api.get(getPath);
+                    logger('GET fallback successful', {
+                        resultCount: response.data.data?.length || 0,
+                    });
+                    return processEntries(response.data.data || []);
+                }
+                catch (getError) {
+                    const err = getError;
+                    logger('GET fallback failed', {
+                        error: err.message,
+                        status: err.response?.status,
+                    }, true);
+                    // Throw the original primary error since it's most relevant
+                    throw primaryError;
+                }
+            }
+            else {
+                // If filters were provided, don't try GET endpoint
+                throw primaryError;
+            }
+        }
+    }
+}
+//# sourceMappingURL=api-fallback.js.map

package/dist/utils/api-fallback.js.map

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

package/dist/utils/attribute-mapping/attribute-mappers.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Converts a value to a boolean based on common string representations
+ *
+ * @param value - The value to convert to boolean
+ * @returns Boolean representation of the value
+ */
+export declare function convertToBoolean(value: any): boolean;
+export declare class AttributeMappingError extends Error {
+    details: Record<string, any>;
+    constructor(message: string, details?: Record<string, any>);
+}
+/**
+ * Invalidates the configuration cache, forcing a reload on next access
+ * This is useful for testing and when configuration files change
+ */
+export declare function invalidateConfigCache(): void;
+/**
+ * Looks up a human-readable attribute name and returns the corresponding slug
+ *
+ * @param attributeName - The user-provided attribute name
+ * @param objectType - Optional object type for object-specific mappings
+ * @returns The slug if found, or the original attributeName if not mapped
+ */
+export declare function getAttributeSlug(attributeName: string, objectType?: string): string;
+/**
+ * Gets the slug for an object type (e.g., "Companies" -> "companies")
+ *
+ * @param objectName - The human-readable object name
+ * @returns The corresponding slug, or a normalized version of the original name if not found
+ */
+export declare function getObjectSlug(objectName: string): string;
+/**
+ * Gets the slug for a list name
+ *
+ * @param listName - The human-readable list name
+ * @returns The corresponding slug, or the original name if not found
+ */
+export declare function getListSlug(listName: string): string;
+//# sourceMappingURL=attribute-mappers.d.ts.map

package/dist/utils/attribute-mapping/attribute-mappers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attribute-mappers.d.ts","sourceRoot":"","sources":["../../../src/utils/attribute-mapping/attribute-mappers.ts"],"names":[],"mappings":"AAeA;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAWpD;AAGD,qBAAa,qBAAsB,SAAQ,KAAK;IAGrC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;gBADnC,OAAO,EAAE,MAAM,EACR,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM;CAK3C;AAmFD;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAW5C;AA4ED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,MAAM,EACrB,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CAkOR;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CA6BxD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA0BpD"}