attio-mcp 0.1.0

package/dist/handlers/tools/dispatcher/operations/search.js

@@ -0,0 +1,190 @@
+/**
+ * Search operation handlers for tool execution
+ *
+ * Handles basic search operations including search, searchByEmail, searchByPhone, and smartSearch
+ */
+import { createErrorResult } from '../../../../utils/error-handler.js';
+import { formatResponse } from '../../formatters.js';
+import { hasResponseData } from '../../error-types.js';
+/**
+ * Check if the formatted results already contain a header to avoid duplication
+ */
+function hasResultHeader(formattedResults) {
+    return (typeof formattedResults === 'string' &&
+        formattedResults.startsWith('Found '));
+}
+/**
+ * Format search results with appropriate header
+ */
+function formatSearchResults(formattedResults, results, resourceType, searchContext) {
+    if (hasResultHeader(formattedResults)) {
+        return formattedResults;
+    }
+    const header = searchContext
+        ? `Found ${results.length} ${resourceType} ${searchContext}:`
+        : `Found ${results.length} ${resourceType}:`;
+    return `${header}\n${formattedResults}`;
+}
+/**
+ * Handle common search operations
+ *
+ * @param toolType - The type of search tool
+ * @param searchConfig - The search tool configuration
+ * @param searchParam - The search parameter
+ * @param resourceType - The resource type being searched
+ * @returns Formatted response
+ */
+export async function handleSearchOperation(toolType, searchConfig, searchParam, resourceType) {
+    try {
+        const results = await searchConfig.handler(searchParam);
+        const formattedResults = searchConfig.formatResult(results);
+        const searchType = toolType.replace('searchBy', '').toLowerCase();
+        const searchContext = `matching ${searchType} "${searchParam}"`;
+        const responseText = formatSearchResults(formattedResults, results, resourceType, searchContext);
+        return formatResponse(responseText);
+    }
+    catch (error) {
+        return createErrorResult(error instanceof Error ? error : new Error('Unknown error'), `/objects/${resourceType}/records/query`, 'POST', hasResponseData(error) ? error.response.data : {});
+    }
+}
+/**
+ * Handle basic search operations
+ */
+export async function handleBasicSearch(request, toolConfig, resourceType) {
+    const queryFromArgs = request.params.arguments?.query;
+    const domainFromArgs = request.params.arguments?.domain;
+    let effectiveQuery = queryFromArgs;
+    // If 'query' is not provided, but 'domain' is, and the specific tool being handled is 'search-companies',
+    // use the 'domain' value as the query. This makes 'search-companies' more robust to this specific invocation pattern.
+    if (effectiveQuery === undefined &&
+        domainFromArgs !== undefined &&
+        toolConfig.name === 'search-companies') {
+        effectiveQuery = domainFromArgs;
+        console.warn(`[handleBasicSearch] Tool 'search-companies' was called with a 'domain' parameter instead of 'query'. ` +
+            `Using the 'domain' value ("${effectiveQuery}") as the search query. ` +
+            `For clarity and future compatibility, please use the 'query' parameter for the 'search-companies' tool, ` +
+            `or use the 'search-companies-by-domain' tool for explicit domain searches.`);
+    }
+    const query = effectiveQuery; // Use 'query' as the variable name for the rest of the function for minimal changes
+    try {
+        const results = await toolConfig.handler(query);
+        const formattedResults = toolConfig.formatResult(results);
+        const responseText = formatSearchResults(formattedResults, results, resourceType);
+        return formatResponse(responseText);
+    }
+    catch (error) {
+        return createErrorResult(error instanceof Error ? error : new Error('Unknown error'), `/objects/${resourceType}/records/query`, 'POST', hasResponseData(error) ? error.response.data : {});
+    }
+}
+/**
+ * Handle searchByEmail operations
+ */
+export async function handleSearchByEmail(request, toolConfig, resourceType) {
+    const email = request.params.arguments?.email;
+    return handleSearchOperation('searchByEmail', toolConfig, email, resourceType);
+}
+/**
+ * Handle searchByPhone operations
+ */
+export async function handleSearchByPhone(request, toolConfig, resourceType) {
+    const phone = request.params.arguments?.phone;
+    return handleSearchOperation('searchByPhone', toolConfig, phone, resourceType);
+}
+/**
+ * Handle searchByDomain operations
+ */
+export async function handleSearchByDomain(request, toolConfig, resourceType) {
+    const domain = request.params.arguments?.domain;
+    return handleSearchOperation('searchByDomain', toolConfig, domain, resourceType);
+}
+/**
+ * Handle searchByCompany operations
+ */
+export async function handleSearchByCompany(request, toolConfig, resourceType) {
+    const companyFilter = request.params.arguments?.companyFilter;
+    // Extract company identifier from filter
+    let companyIdentifier;
+    if (typeof companyFilter === 'string') {
+        companyIdentifier = companyFilter;
+    }
+    else if (typeof companyFilter === 'object' && companyFilter !== null) {
+        // Handle object format with filters array
+        if ('filters' in companyFilter &&
+            Array.isArray(companyFilter.filters) &&
+            companyFilter.filters.length > 0) {
+            const firstFilter = companyFilter.filters[0];
+            if (typeof firstFilter === 'object' &&
+                firstFilter !== null &&
+                'value' in firstFilter) {
+                const value = firstFilter.value;
+                // Extract record_id if it's an object with record_id, otherwise use the value directly
+                if (typeof value === 'object' &&
+                    value !== null &&
+                    'record_id' in value) {
+                    companyIdentifier = value.record_id;
+                }
+                else {
+                    companyIdentifier = String(value);
+                }
+            }
+            else {
+                throw new Error('Invalid filter structure in companyFilter');
+            }
+        }
+        else if ('value' in companyFilter) {
+            // Handle direct value format
+            const value = companyFilter.value;
+            if (typeof value === 'object' && value !== null && 'record_id' in value) {
+                companyIdentifier = value.record_id;
+            }
+            else {
+                companyIdentifier = String(value);
+            }
+        }
+        else {
+            throw new Error('Invalid companyFilter format: missing filters array or value');
+        }
+    }
+    else if (Array.isArray(companyFilter) && companyFilter.length > 0) {
+        // Handle array format - use the first valid filter
+        const firstFilter = companyFilter[0];
+        if (typeof firstFilter === 'object' &&
+            firstFilter !== null &&
+            'value' in firstFilter) {
+            const value = firstFilter.value;
+            if (typeof value === 'object' && value !== null && 'record_id' in value) {
+                companyIdentifier = value.record_id;
+            }
+            else {
+                companyIdentifier = String(value);
+            }
+        }
+        else {
+            companyIdentifier = String(firstFilter);
+        }
+    }
+    else {
+        throw new Error('Invalid companyFilter format');
+    }
+    return handleSearchOperation('searchByCompany', toolConfig, companyIdentifier, resourceType);
+}
+/**
+ * Handle smartSearch operations
+ */
+export async function handleSmartSearch(request, toolConfig, resourceType) {
+    const query = request.params.arguments?.query;
+    // Validate query parameter
+    if (!query || typeof query !== 'string' || query.trim().length === 0) {
+        return createErrorResult(new Error('Query parameter is required for smart search and must be a non-empty string'), `/objects/${resourceType}/smart-search`, 'POST', { status: 400, message: 'Missing or invalid required parameter: query' });
+    }
+    try {
+        const results = await toolConfig.handler(query);
+        const formattedResults = toolConfig.formatResult(results);
+        const responseText = formatSearchResults(formattedResults, results, resourceType, '(smart search)');
+        return formatResponse(responseText);
+    }
+    catch (error) {
+        return createErrorResult(error instanceof Error ? error : new Error('Unknown error'), `/objects/${resourceType}/records/query`, 'POST', hasResponseData(error) ? error.response.data : {});
+    }
+}
+//# sourceMappingURL=search.js.map

package/dist/handlers/tools/dispatcher/operations/search.js.map

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

package/dist/handlers/tools/dispatcher/validation.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Validation utilities for tool execution
+ *
+ * Provides parameter validation and resource ID validation for tool requests
+ */
+import { createErrorResult } from '../../../utils/error-handler.js';
+import { ResourceType } from '../../../types/attio.js';
+import { AttributeValidationParams, ValidationResult } from '../../../types/tool-types.js';
+/**
+ * Validates attribute parameters for company operations
+ *
+ * @param attributes - The attributes object to validate (key-value pairs of company attributes)
+ * @returns True if validation passes, or an error message string if validation fails
+ */
+export declare function validateAttributes(attributes: AttributeValidationParams | null | undefined): ValidationResult;
+/**
+ * Helper function to validate and extract resource ID based on resource type
+ *
+ * @param resourceType - The type of resource (companies, people, etc.)
+ * @param args - The request arguments containing the ID
+ * @param apiPath - The API path for error reporting
+ * @returns The validated ID or an error response
+ */
+export declare function validateResourceId(resourceType: ResourceType, args: any, apiPath: string): string | {
+    error: ReturnType<typeof createErrorResult>;
+};
+//# sourceMappingURL=validation.d.ts.map

package/dist/handlers/tools/dispatcher/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../src/handlers/tools/dispatcher/validation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EACL,yBAAyB,EACzB,gBAAgB,EACjB,MAAM,8BAA8B,CAAC;AAEtC;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,yBAAyB,GAAG,IAAI,GAAG,SAAS,GACvD,gBAAgB,CAclB;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,YAAY,EAC1B,IAAI,EAAE,GAAG,EACT,OAAO,EAAE,MAAM,GACd,MAAM,GAAG;IAAE,KAAK,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAA;CAAE,CAoB1D"}

package/dist/handlers/tools/dispatcher/validation.js

@@ -0,0 +1,47 @@
+/**
+ * Validation utilities for tool execution
+ *
+ * Provides parameter validation and resource ID validation for tool requests
+ */
+import { createErrorResult } from '../../../utils/error-handler.js';
+import { ResourceType } from '../../../types/attio.js';
+/**
+ * Validates attribute parameters for company operations
+ *
+ * @param attributes - The attributes object to validate (key-value pairs of company attributes)
+ * @returns True if validation passes, or an error message string if validation fails
+ */
+export function validateAttributes(attributes) {
+    if (!attributes) {
+        return 'Attributes parameter is required';
+    }
+    if (typeof attributes !== 'object' || Array.isArray(attributes)) {
+        return 'Attributes parameter must be an object';
+    }
+    if (Object.keys(attributes).length === 0) {
+        return 'Attributes parameter cannot be empty';
+    }
+    return true;
+}
+/**
+ * Helper function to validate and extract resource ID based on resource type
+ *
+ * @param resourceType - The type of resource (companies, people, etc.)
+ * @param args - The request arguments containing the ID
+ * @param apiPath - The API path for error reporting
+ * @returns The validated ID or an error response
+ */
+export function validateResourceId(resourceType, args, apiPath) {
+    const idParamName = resourceType === ResourceType.COMPANIES ? 'companyId' : 'personId';
+    const id = args?.[idParamName];
+    if (!id) {
+        return {
+            error: createErrorResult(new Error(`${idParamName} parameter is required`), apiPath, 'GET', {
+                status: 400,
+                message: `Missing required parameter: ${idParamName}`,
+            }),
+        };
+    }
+    return id;
+}
+//# sourceMappingURL=validation.js.map

package/dist/handlers/tools/dispatcher/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../../src/handlers/tools/dispatcher/validation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAMvD;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAChC,UAAwD;IAExD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,kCAAkC,CAAC;IAC5C,CAAC;IAED,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QAChE,OAAO,wCAAwC,CAAC;IAClD,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzC,OAAO,sCAAsC,CAAC;IAChD,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAChC,YAA0B,EAC1B,IAAS,EACT,OAAe;IAEf,MAAM,WAAW,GACf,YAAY,KAAK,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC;IACrE,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC,WAAW,CAAW,CAAC;IAEzC,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,OAAO;YACL,KAAK,EAAE,iBAAiB,CACtB,IAAI,KAAK,CAAC,GAAG,WAAW,wBAAwB,CAAC,EACjD,OAAO,EACP,KAAK,EACL;gBACE,MAAM,EAAE,GAAG;gBACX,OAAO,EAAE,+BAA+B,WAAW,EAAE;aACtD,CACF;SACF,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/handlers/tools/dispatcher.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Tool dispatcher module - handles tool execution dispatch and routing
+ *
+ * This module re-exports from the modular dispatcher implementation for backward compatibility.
+ * The actual implementation has been broken down into focused modules under ./dispatcher/
+ */
+export { executeToolRequest } from './dispatcher/core.js';
+export { logToolRequest, logToolError } from './dispatcher/logging.js';
+export { validateAttributes, validateResourceId, } from './dispatcher/validation.js';
+export { formatSuccessResponse } from './dispatcher/formatting.js';
+//# sourceMappingURL=dispatcher.d.ts.map

package/dist/handlers/tools/dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../../src/handlers/tools/dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG1D,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EACL,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/handlers/tools/dispatcher.js

@@ -0,0 +1,15 @@
+/**
+ * Tool dispatcher module - handles tool execution dispatch and routing
+ *
+ * This module re-exports from the modular dispatcher implementation for backward compatibility.
+ * The actual implementation has been broken down into focused modules under ./dispatcher/
+ */
+// Re-export the main executeToolRequest function from the modular implementation
+export { executeToolRequest } from './dispatcher/core.js';
+// Re-export utility functions from the modular implementation for backward compatibility
+export { logToolRequest, logToolError } from './dispatcher/logging.js';
+export { validateAttributes, validateResourceId, } from './dispatcher/validation.js';
+export { formatSuccessResponse } from './dispatcher/formatting.js';
+// Note: Legacy implementation placeholders below will be moved to dedicated operation modules in Phase 2
+// These are temporarily retained for any unimplemented operations until full modularization is complete
+//# sourceMappingURL=dispatcher.js.map

package/dist/handlers/tools/dispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.js","sourceRoot":"","sources":["../../../src/handlers/tools/dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,iFAAiF;AACjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,yFAAyF;AACzF,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EACL,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,yGAAyG;AACzG,wGAAwG"}

package/dist/handlers/tools/error-types.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Error types for tool operations
+ */
+/**
+ * Interface for API errors with response data
+ */
+export interface ApiError extends Error {
+    response?: {
+        data: any;
+        status: number;
+    };
+    details?: any;
+}
+/**
+ * Interface for ValueMatchError with original error
+ */
+export interface ValueMatchApiError extends Error {
+    originalError?: ApiError;
+    details?: any;
+}
+/**
+ * Type guard to check if error is an ApiError
+ */
+export declare function isApiError(error: unknown): error is ApiError;
+/**
+ * Type guard to check if error has response data
+ */
+export declare function hasResponseData(error: unknown): error is {
+    response: {
+        data: any;
+    };
+};
+//# sourceMappingURL=error-types.d.ts.map

package/dist/handlers/tools/error-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-types.d.ts","sourceRoot":"","sources":["../../../src/handlers/tools/error-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,QAAS,SAAQ,KAAK;IACrC,QAAQ,CAAC,EAAE;QACT,IAAI,EAAE,GAAG,CAAC;QACV,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,OAAO,CAAC,EAAE,GAAG,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,KAAK;IAC/C,aAAa,CAAC,EAAE,QAAQ,CAAC;IACzB,OAAO,CAAC,EAAE,GAAG,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE5D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,OAAO,GACb,KAAK,IAAI;IAAE,QAAQ,EAAE;QAAE,IAAI,EAAE,GAAG,CAAA;KAAE,CAAA;CAAE,CAStC"}

package/dist/handlers/tools/error-types.js

@@ -0,0 +1,21 @@
+/**
+ * Error types for tool operations
+ */
+/**
+ * Type guard to check if error is an ApiError
+ */
+export function isApiError(error) {
+    return error instanceof Error && 'response' in error;
+}
+/**
+ * Type guard to check if error has response data
+ */
+export function hasResponseData(error) {
+    return (error !== null &&
+        typeof error === 'object' &&
+        'response' in error &&
+        error.response !== null &&
+        typeof error.response === 'object' &&
+        'data' in error.response);
+}
+//# sourceMappingURL=error-types.js.map

package/dist/handlers/tools/error-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-types.js","sourceRoot":"","sources":["../../../src/handlers/tools/error-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAqBH;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO,KAAK,YAAY,KAAK,IAAI,UAAU,IAAI,KAAK,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAc;IAEd,OAAO,CACL,KAAK,KAAK,IAAI;QACd,OAAO,KAAK,KAAK,QAAQ;QACzB,UAAU,IAAI,KAAK;QACnB,KAAK,CAAC,QAAQ,KAAK,IAAI;QACvB,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ;QAClC,MAAM,IAAI,KAAK,CAAC,QAAQ,CACzB,CAAC;AACJ,CAAC"}

package/dist/handlers/tools/formatters.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Result formatting module - handles transformation and formatting of tool results
+ */
+import { AttioRecord, AttioListEntry } from '../../types/attio.js';
+/**
+ * Format search results for display
+ *
+ * @param results - Array of search results
+ * @param resourceType - The type of resource being searched
+ * @returns Formatted string output
+ */
+export declare function formatSearchResults(results: AttioRecord[], resourceType: string): string;
+/**
+ * Format record details for display
+ *
+ * @param record - The record to format
+ * @returns Formatted string output
+ */
+export declare function formatRecordDetails(record: AttioRecord): string;
+/**
+ * Format list entries for display
+ *
+ * @param entries - Array of list entries
+ * @returns Formatted string output
+ */
+export declare function formatListEntries(entries: AttioListEntry[]): string;
+/**
+ * Format batch operation results for display
+ *
+ * @param result - Batch operation result
+ * @param operation - The type of batch operation
+ * @returns Formatted string output
+ */
+export declare function formatBatchResults(result: any, operation: string): string;
+/**
+ * Format standard response content
+ *
+ * @param content - The content to format
+ * @param isError - Whether this is an error response
+ * @returns Formatted response object
+ */
+export declare function formatResponse(content: string | any, isError?: boolean): any;
+//# sourceMappingURL=formatters.d.ts.map

package/dist/handlers/tools/formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../../../src/handlers/tools/formatters.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,WAAW,EAAE,cAAc,EAAc,MAAM,sBAAsB,CAAC;AAwD/E;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,WAAW,EAAE,EACtB,YAAY,EAAE,MAAM,GACnB,MAAM,CAYR;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAc/D;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,MAAM,CAiBnE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAezE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,GAAG,GAAG,EACrB,OAAO,GAAE,OAAe,OAoDzB"}

package/dist/handlers/tools/formatters.js

@@ -0,0 +1,170 @@
+import { processListEntries } from '../../utils/record-utils.js';
+import { safeJsonStringify, sanitizeMcpResponse, } from '../../utils/json-serializer.js';
+/**
+ * Safely extract value from record attributes
+ *
+ * This function handles various record formats and extracts values from them,
+ * including standard AttioRecord objects and similar record-like structures
+ * that may come from different API responses or transformations.
+ *
+ * @param record - The record to extract the value from, which might be an AttioRecord or a similar structure
+ * @param fieldName - The name of the field to extract
+ * @returns The extracted value as a string, or 'Unknown' if not found
+ */
+function getAttributeValue(record, fieldName) {
+    if (!record?.values)
+        return 'Unknown';
+    const fieldValue = record.values[fieldName];
+    if (!fieldValue)
+        return 'Unknown';
+    // Handle different value formats
+    if (Array.isArray(fieldValue) && fieldValue.length > 0) {
+        const firstValue = fieldValue[0];
+        if (typeof firstValue === 'object' &&
+            firstValue !== null &&
+            'value' in firstValue) {
+            return firstValue.value || 'Unknown';
+        }
+        return String(firstValue) || 'Unknown';
+    }
+    else if (typeof fieldValue === 'object' &&
+        fieldValue !== null &&
+        'value' in fieldValue) {
+        return fieldValue.value || 'Unknown';
+    }
+    // Fallback for any other format
+    return String(fieldValue) || 'Unknown';
+}
+/**
+ * Format search results for display
+ *
+ * @param results - Array of search results
+ * @param resourceType - The type of resource being searched
+ * @returns Formatted string output
+ */
+export function formatSearchResults(results, resourceType) {
+    if (!results || results.length === 0) {
+        return `No ${resourceType} found.`;
+    }
+    return results
+        .map((record, index) => {
+        const name = getAttributeValue(record, 'name');
+        const id = record.id?.record_id || 'Unknown ID';
+        return `${index + 1}. ${name} (ID: ${id})`;
+    })
+        .join('\n');
+}
+/**
+ * Format record details for display
+ *
+ * @param record - The record to format
+ * @returns Formatted string output
+ */
+export function formatRecordDetails(record) {
+    if (!record) {
+        return 'No record found.';
+    }
+    const attributes = record.attributes || {};
+    const formattedAttrs = Object.entries(attributes)
+        .map(([key, attr]) => {
+        const value = attr.value || 'N/A';
+        return `${key}: ${value}`;
+    })
+        .join('\n');
+    return `Record Details:\n${formattedAttrs}`;
+}
+/**
+ * Format list entries for display
+ *
+ * @param entries - Array of list entries
+ * @returns Formatted string output
+ */
+export function formatListEntries(entries) {
+    if (!entries || entries.length === 0) {
+        return 'No entries found.';
+    }
+    const processedEntries = processListEntries(entries);
+    return processedEntries
+        .map((entry, index) => {
+        const record = entry.record;
+        const name = getAttributeValue(record, 'name');
+        const entryId = entry.id?.entry_id || 'Unknown Entry ID';
+        const recordId = record?.id?.record_id || 'Unknown ID';
+        return `${index + 1}. ${name} (Entry: ${entryId}, Record: ${recordId})`;
+    })
+        .join('\n');
+}
+/**
+ * Format batch operation results for display
+ *
+ * @param result - Batch operation result
+ * @param operation - The type of batch operation
+ * @returns Formatted string output
+ */
+export function formatBatchResults(result, operation) {
+    const summary = result.summary;
+    const details = result.results
+        .map((r) => r.success
+        ? `✅ Record ${r.id}: ${operation} successfully`
+        : `❌ Record ${r.id}: Failed - ${r.error?.message || 'Unknown error'}`)
+        .join('\n');
+    return (`Batch ${operation} operation completed:\n` +
+        `Total: ${summary.total}, Succeeded: ${summary.succeeded}, Failed: ${summary.failed}\n` +
+        details);
+}
+/**
+ * Format standard response content
+ *
+ * @param content - The content to format
+ * @param isError - Whether this is an error response
+ * @returns Formatted response object
+ */
+export function formatResponse(content, isError = false) {
+    // Handle non-string content by converting it to a string
+    let formattedContent;
+    if (typeof content === 'string') {
+        formattedContent = content;
+    }
+    else if (content === undefined || content === null) {
+        // Prevent "undefined" or "null" from being returned as response content
+        formattedContent = isError
+            ? 'An unknown error occurred'
+            : 'Operation completed successfully, but no content was returned';
+    }
+    else {
+        try {
+            // Try to convert the content to a string representation using safe serialization
+            formattedContent =
+                typeof content === 'object'
+                    ? safeJsonStringify(content, {
+                        maxDepth: 6,
+                        includeStackTraces: false,
+                    })
+                    : String(content);
+        }
+        catch (error) {
+            if (process.env.DEBUG || process.env.NODE_ENV === 'development') {
+                console.error('[formatResponse] Error converting content to string:', error);
+            }
+            formattedContent = 'Error: Content could not be serialized';
+        }
+    }
+    // Ensure we never return empty content
+    if (!formattedContent) {
+        formattedContent = isError
+            ? 'An unknown error occurred'
+            : 'Operation completed successfully';
+    }
+    const response = {
+        content: [
+            {
+                type: 'text',
+                text: formattedContent,
+            },
+        ],
+        isError,
+    };
+    // Sanitize the final response to ensure it's MCP-compatible
+    return sanitizeMcpResponse(response);
+}
+//# sourceMappingURL=formatters.js.map

package/dist/handlers/tools/formatters.js.map

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

package/dist/handlers/tools/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Main entry point for tool handlers - maintains backward compatibility
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+/**
+ * Registers tool-related request handlers with the server
+ *
+ * @param server - The MCP server instance
+ */
+export declare function registerToolHandlers(server: Server): void;
+export { TOOL_DEFINITIONS, TOOL_CONFIGS } from './registry.js';
+export { findToolConfig } from './registry.js';
+export { executeToolRequest } from './dispatcher.js';
+export { formatSearchResults, formatRecordDetails, formatListEntries, formatBatchResults, formatResponse, } from './formatters.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/handlers/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/handlers/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAWnE;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAkBzD;AAGD,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,GACf,MAAM,iBAAiB,CAAC"}