@iflow-mcp/attio-mcp 1.3.6

package/dist/handlers/tool-configs/universal/validators/schema-validator.js

@@ -0,0 +1,326 @@
+import { ErrorType, HttpStatusCode, UniversalValidationError, } from '../errors/validation-errors.js';
+import { UniversalResourceType } from '../types.js';
+import { suggestResourceType, validateIdFields, validatePaginationParams, } from './field-validator.js';
+export class InputSanitizer {
+    static sanitizeString(input) {
+        if (typeof input !== 'string') {
+            return String(input);
+        }
+        let s = input;
+        s = s.replace(/<script\b[^>]*>([\s\S]*?)<\/script>/gi, '$1');
+        s = s.replace(/on\w+\s*=\s*([^>\s]*)/gi, '$1');
+        s = s.replace(/<\/?[^>]+>/g, '');
+        return s.replace(/\s+/g, ' ').trim();
+    }
+    static normalizeEmail(email) {
+        if (typeof email !== 'string') {
+            return String(email).trim().toLowerCase();
+        }
+        return email.trim().toLowerCase();
+    }
+    static sanitizeObject(obj) {
+        if (obj === null)
+            return null;
+        if (obj === undefined)
+            return null;
+        if (typeof obj === 'string') {
+            return this.sanitizeString(obj);
+        }
+        if (Array.isArray(obj)) {
+            return obj.map((item) => this.sanitizeObject(item));
+        }
+        if (typeof obj === 'number' || typeof obj === 'boolean') {
+            return obj;
+        }
+        if (typeof obj === 'object') {
+            const result = {};
+            for (const [key, value] of Object.entries(obj)) {
+                const lowerKey = key.toLowerCase();
+                if (lowerKey === 'email' && typeof value === 'string') {
+                    result[key] = this.normalizeEmail(value);
+                    continue;
+                }
+                if (lowerKey === 'email_address' && typeof value === 'string') {
+                    result[key] = this.normalizeEmail(value);
+                    continue;
+                }
+                if (lowerKey === 'email_addresses' && Array.isArray(value)) {
+                    result[key] = value.map((v) => typeof v === 'string'
+                        ? this.normalizeEmail(v)
+                        : this.sanitizeObject(v));
+                    continue;
+                }
+                result[key] = this.sanitizeObject(value);
+            }
+            return result;
+        }
+        return String(obj);
+    }
+}
+const toolValidators = {
+    // Universal tools with underscore names (Issue #776 Phase 0)
+    records_search: (p) => {
+        if (!p.resource_type) {
+            throw new UniversalValidationError('Missing required parameter: resource_type', ErrorType.USER_ERROR, {
+                field: 'resource_type',
+                suggestion: 'Specify which type of records to search',
+                example: `resource_type: 'companies' | 'people' | 'records' | 'tasks'`,
+            });
+        }
+        return p;
+    },
+    records_get_details: (p) => {
+        if (!p.resource_type) {
+            throw new UniversalValidationError('Missing required parameter: resource_type', ErrorType.USER_ERROR, { field: 'resource_type', example: `resource_type: 'companies'` });
+        }
+        if (!p.record_id) {
+            throw new UniversalValidationError('Missing required parameter: record_id', ErrorType.USER_ERROR, {
+                field: 'record_id',
+                suggestion: 'Provide the unique identifier of the record to retrieve',
+                example: `record_id: 'comp_abc123'`,
+            });
+        }
+        return p;
+    },
+    records_get_attributes: (p) => {
+        if (!p.resource_type) {
+            throw new UniversalValidationError('Missing required parameter: resource_type', ErrorType.USER_ERROR, {
+                field: 'resource_type',
+                suggestion: 'Specify which resource type to get attributes for',
+                example: `resource_type: 'companies' | 'people' | 'records' | 'tasks'`,
+            });
+        }
+        return p;
+    },
+    records_discover_attributes: (p) => {
+        if (!p.resource_type) {
+            throw new UniversalValidationError('Missing required parameter: resource_type', ErrorType.USER_ERROR, {
+                field: 'resource_type',
+                suggestion: 'Specify which resource type to discover attributes for',
+                example: `resource_type: 'companies' | 'people' | 'records' | 'tasks'`,
+            });
+        }
+        return p;
+    },
+    records_get_info: (p) => {
+        if (!p.resource_type) {
+            throw new UniversalValidationError('Missing required parameter: resource_type', ErrorType.USER_ERROR, { field: 'resource_type', example: `resource_type: 'companies'` });
+        }
+        if (!p.record_id) {
+            throw new UniversalValidationError('Missing required parameter: record_id', ErrorType.USER_ERROR, {
+                field: 'record_id',
+                suggestion: 'Provide the unique identifier of the record to get info for',
+                example: `record_id: 'comp_abc123'`,
+            });
+        }
+        return p;
+    },
+    // Legacy CRUD tools (still using hyphenated names)
+    create_record: (p) => {
+        if (!p.resource_type) {
+            throw new UniversalValidationError('Missing required parameter: resource_type', ErrorType.USER_ERROR, { field: 'resource_type', example: `resource_type: 'companies'` });
+        }
+        if (!p.record_data) {
+            throw new UniversalValidationError('Missing required parameter: record_data', ErrorType.USER_ERROR, {
+                field: 'record_data',
+                suggestion: 'Provide the data for creating the new record',
+                example: `record_data: { name: 'Company Name', domain: 'example.com' }`,
+            });
+        }
+        return p;
+    },
+    update_record: (p) => {
+        if (!p.resource_type) {
+            throw new UniversalValidationError('Missing required parameter: resource_type', ErrorType.USER_ERROR, { field: 'resource_type', example: `resource_type: 'companies'` });
+        }
+        if (!p.record_id) {
+            throw new UniversalValidationError('Missing required parameter: record_id', ErrorType.USER_ERROR, { field: 'record_id', example: `record_id: 'comp_abc123'` });
+        }
+        if (!p.record_data) {
+            throw new UniversalValidationError('Missing required parameter: record_data', ErrorType.USER_ERROR, {
+                field: 'record_data',
+                suggestion: 'Provide the data to update the record with',
+                example: `record_data: { name: 'Updated Name' }`,
+            });
+        }
+        if (p.resource_type === 'tasks') {
+            const forbidden = ['content', 'content_markdown', 'content_plaintext'];
+            if (p.record_data && typeof p.record_data === 'object') {
+                const recordData = p.record_data;
+                for (const k of forbidden) {
+                    if (k in recordData) {
+                        throw new UniversalValidationError('Task content is immutable and cannot be updated');
+                    }
+                }
+            }
+        }
+        return p;
+    },
+    delete_record: (p) => {
+        if (!p.resource_type) {
+            throw new UniversalValidationError('Missing required parameter: resource_type', ErrorType.USER_ERROR, { field: 'resource_type', example: `resource_type: 'companies'` });
+        }
+        if (!p.record_id) {
+            throw new UniversalValidationError('Missing required parameter: record_id', ErrorType.USER_ERROR, {
+                field: 'record_id',
+                suggestion: 'Provide the ID of the record to delete',
+                example: `record_id: 'comp_abc123'`,
+            });
+        }
+        return p;
+    },
+    create_note: (p) => {
+        if (!p.resource_type) {
+            throw new UniversalValidationError('Missing required parameter: resource_type', ErrorType.USER_ERROR, { field: 'resource_type', example: `resource_type: 'deals'` });
+        }
+        if (!p.record_id) {
+            throw new UniversalValidationError('Missing required parameter: record_id', ErrorType.USER_ERROR, {
+                field: 'record_id',
+                suggestion: 'Provide the ID of the record to attach the note to',
+                example: `record_id: '35dfdec5-f4a6-4a53-b5e0-f0809224e156'`,
+            });
+        }
+        if (!p.title) {
+            throw new UniversalValidationError('Missing required parameter: title', ErrorType.USER_ERROR, {
+                field: 'title',
+                suggestion: 'Provide a title for the note',
+                example: `title: 'Meeting notes'`,
+            });
+        }
+        if (!p.content) {
+            throw new UniversalValidationError('Missing required parameter: content', ErrorType.USER_ERROR, {
+                field: 'content',
+                suggestion: 'Provide content for the note',
+                example: `content: 'Discussion about project timeline'`,
+            });
+        }
+        return p;
+    },
+    'get-notes': (p) => p,
+    'search-notes': (p) => p,
+    'update-note': (p) => {
+        if (!p.note_id) {
+            throw new UniversalValidationError('Missing required parameter: note_id', ErrorType.USER_ERROR, {
+                field: 'note_id',
+                suggestion: 'Provide the ID of the note to update',
+                example: `note_id: 'note_abc123'`,
+            });
+        }
+        return p;
+    },
+    'delete-note': (p) => {
+        if (!p.note_id) {
+            throw new UniversalValidationError('Missing required parameter: note_id', ErrorType.USER_ERROR, {
+                field: 'note_id',
+                suggestion: 'Provide the ID of the note to delete',
+                example: `note_id: 'note_abc123'`,
+            });
+        }
+        return p;
+    },
+    records_batch: (p) => {
+        if (!p.resource_type) {
+            throw new UniversalValidationError('Missing required parameter: resource_type', ErrorType.USER_ERROR, { field: 'resource_type', example: `resource_type: 'companies'` });
+        }
+        // Support both new flexible format (operations array) and legacy format (operation_type)
+        const hasOperations = p.operations && Array.isArray(p.operations) && p.operations.length > 0;
+        const hasLegacyFormat = p.operation_type;
+        if (!hasOperations && !hasLegacyFormat) {
+            throw new UniversalValidationError('Missing required parameters: either "operations" array or "operation_type"', ErrorType.USER_ERROR, {
+                field: 'operations',
+                example: `operations: [{ operation: 'create', record_data: { name: 'Example' } }]`,
+                suggestion: 'Use either the new operations array format or legacy operation_type + records format',
+            });
+        }
+        // Validate new format
+        if (hasOperations) {
+            const operations = p.operations;
+            for (let index = 0; index < operations.length; index++) {
+                const op = operations[index];
+                if (!op.operation) {
+                    throw new UniversalValidationError(`Missing operation type for operation at index ${index}`, ErrorType.USER_ERROR, {
+                        field: `operations[${index}].operation`,
+                        example: `operation: 'create'`,
+                    });
+                }
+                if (!op.record_data) {
+                    throw new UniversalValidationError(`Missing record_data for operation at index ${index}`, ErrorType.USER_ERROR, {
+                        field: `operations[${index}].record_data`,
+                        example: `record_data: { name: 'Example' }`,
+                    });
+                }
+            }
+        }
+        // Validate legacy format
+        if (hasLegacyFormat) {
+            const operationType = String(p.operation_type);
+            if (['create', 'update'].includes(operationType) && !p.records) {
+                throw new UniversalValidationError(`Missing required parameter for ${operationType} operations: records`, ErrorType.USER_ERROR, {
+                    field: 'records',
+                    suggestion: `Provide an array of record data for ${operationType} operations`,
+                    example: `records: [{ name: 'Company 1' }, { name: 'Company 2' }]`,
+                });
+            }
+            if (['delete', 'get'].includes(operationType) && !p.record_ids) {
+                throw new UniversalValidationError(`Missing required parameter for ${operationType} operations: record_ids`, ErrorType.USER_ERROR, {
+                    field: 'record_ids',
+                    suggestion: `Provide an array of record IDs for ${operationType} operations`,
+                    example: `record_ids: ['comp_abc123', 'comp_def456']`,
+                });
+            }
+        }
+        return p;
+    },
+    list_notes: (p) => {
+        const candidateParams = p;
+        if (!p.record_id && typeof candidateParams.parent_record_id === 'string') {
+            p.record_id = candidateParams.parent_record_id;
+        }
+        if (!p.resource_type) {
+            throw new UniversalValidationError('Missing required parameter: resource_type', ErrorType.USER_ERROR, { field: 'resource_type', example: `resource_type: 'companies'` });
+        }
+        if (!p.record_id) {
+            throw new UniversalValidationError('Missing required parameter: record_id', ErrorType.USER_ERROR, {
+                field: 'record_id',
+                suggestion: 'Provide the ID of the record to list notes for',
+                example: `record_id: '35dfdec5-f4a6-4a53-b5e0-f0809224e156'`,
+            });
+        }
+        return p;
+    },
+};
+export function validateUniversalToolParams(toolName, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+params) {
+    const sanitizedValue = InputSanitizer.sanitizeObject(params);
+    if (!sanitizedValue ||
+        typeof sanitizedValue !== 'object' ||
+        Array.isArray(sanitizedValue)) {
+        throw new UniversalValidationError('Invalid parameters: expected an object', ErrorType.USER_ERROR, {
+            suggestion: 'Provide parameters as an object',
+            example: '{ resource_type: "companies", ... }',
+            httpStatusCode: HttpStatusCode.UNPROCESSABLE_ENTITY,
+        });
+    }
+    const sanitizedParams = sanitizedValue;
+    validatePaginationParams(sanitizedParams);
+    validateIdFields(sanitizedParams);
+    if (sanitizedParams.resource_type) {
+        const resourceType = String(sanitizedParams.resource_type);
+        if (!Object.values(UniversalResourceType).includes(resourceType)) {
+            const suggestion = suggestResourceType(resourceType);
+            const validTypes = Object.values(UniversalResourceType).join(', ');
+            throw new UniversalValidationError(`Invalid resource_type: '${resourceType}'`, ErrorType.USER_ERROR, {
+                field: 'resource_type',
+                suggestion: suggestion ? `Did you mean '${suggestion}'?` : undefined,
+                example: `Expected one of: ${validTypes}`,
+                httpStatusCode: HttpStatusCode.UNPROCESSABLE_ENTITY,
+            });
+        }
+    }
+    const validator = toolValidators[toolName];
+    if (validator)
+        return validator(sanitizedParams);
+    return sanitizedParams;
+}
+//# sourceMappingURL=schema-validator.js.map

package/dist/handlers/tool-configs/universal/validators/schema-validator.js.map

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

package/dist/handlers/tool-configs/workspace-members.d.ts

@@ -0,0 +1,92 @@
+import { ToolConfig } from '../tool-types.js';
+export declare const workspaceMembersToolConfigs: {
+    listWorkspaceMembers: ToolConfig;
+    searchWorkspaceMembers: ToolConfig;
+    getWorkspaceMember: ToolConfig;
+};
+export declare const workspaceMembersToolDefinitions: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            search: {
+                type: string;
+                description: string;
+                example: string;
+                minLength: number;
+            };
+            page: {
+                type: string;
+                description: string;
+                default: number;
+                minimum: number;
+                example: number;
+            };
+            pageSize: {
+                type: string;
+                description: string;
+                default: number;
+                minimum: number;
+                maximum: number;
+                example: number;
+            };
+            query?: undefined;
+            memberId?: undefined;
+        };
+        additionalProperties: boolean;
+        required?: undefined;
+    };
+    annotations: {
+        readOnlyHint: boolean;
+        idempotentHint: boolean;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            query: {
+                type: string;
+                description: string;
+                minLength: number;
+                example: string;
+            };
+            search?: undefined;
+            page?: undefined;
+            pageSize?: undefined;
+            memberId?: undefined;
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+    annotations: {
+        readOnlyHint: boolean;
+        idempotentHint: boolean;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            memberId: {
+                type: string;
+                description: string;
+                example: string;
+            };
+            search?: undefined;
+            page?: undefined;
+            pageSize?: undefined;
+            query?: undefined;
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+    annotations: {
+        readOnlyHint: boolean;
+        idempotentHint: boolean;
+    };
+})[];
+//# sourceMappingURL=workspace-members.d.ts.map

package/dist/handlers/tool-configs/workspace-members.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-members.d.ts","sourceRoot":"","sources":["../../../src/handlers/tool-configs/workspace-members.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AA2B9C,eAAO,MAAM,2BAA2B;0BAMjC,UAAU;4BAWV,UAAU;wBAwBV,UAAU;CAChB,CAAC;AAEF,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAmG3C,CAAC"}

package/dist/handlers/tool-configs/workspace-members.js

@@ -0,0 +1,147 @@
+import { listWorkspaceMembers, searchWorkspaceMembers, getWorkspaceMember, } from '../../objects/workspace-members.js';
+import { formatToolDescription } from '../../handlers/tools/standards/index.js';
+const formatWorkspaceMemberSummary = (member) => {
+    const name = [member.first_name, member.last_name].filter(Boolean).join(' ');
+    const displayName = name || 'Unknown';
+    const email = member.email_address || 'No email';
+    const access = member.access_level || 'unknown';
+    return `- ${displayName} (${email}) [${access}] - ID: ${member.id.workspace_member_id}`;
+};
+const formatWorkspaceMembersList = (members, descriptor, emptyMessage) => {
+    if (!members || members.length === 0)
+        return emptyMessage;
+    const descriptorText = descriptor
+        ? `${descriptor} workspace members`
+        : 'workspace members';
+    return `Found ${members.length} ${descriptorText}:\n${members
+        .map(formatWorkspaceMemberSummary)
+        .join('\n')}`;
+};
+export const workspaceMembersToolConfigs = {
+    listWorkspaceMembers: {
+        name: 'list-workspace-members',
+        handler: listWorkspaceMembers,
+        formatResult: (members) => formatWorkspaceMembersList(members, '', 'No workspace members found.'),
+    },
+    searchWorkspaceMembers: {
+        name: 'search-workspace-members',
+        handler: searchWorkspaceMembers,
+        formatResult: (members) => formatWorkspaceMembersList(members, 'matching', 'No matching workspace members found.'),
+    },
+    getWorkspaceMember: {
+        name: 'get-workspace-member',
+        handler: getWorkspaceMember,
+        formatResult: (member) => {
+            if (!member) {
+                return 'Workspace member not found.';
+            }
+            const name = [member.first_name, member.last_name]
+                .filter(Boolean)
+                .join(' ');
+            const displayName = name || 'Unknown';
+            const email = member.email_address || 'No email';
+            const access = member.access_level || 'unknown';
+            return `Workspace Member Details:
+- Name: ${displayName}
+- Email: ${email}
+- Access Level: ${access}
+- ID: ${member.id.workspace_member_id}
+- Created: ${member.created_at}
+- Updated: ${member.updated_at}`;
+        },
+    },
+};
+export const workspaceMembersToolDefinitions = [
+    {
+        name: 'list-workspace-members',
+        description: formatToolDescription({
+            capability: 'List workspace members to plan assignments and access checks.',
+            boundaries: 'change access levels or invite new members; read-only.',
+            constraints: 'Supports optional search, pagination (1-100 per page, default 25).',
+            recoveryHint: 'Use search-workspace-members for targeted lookups.',
+        }),
+        inputSchema: {
+            type: 'object',
+            properties: {
+                search: {
+                    type: 'string',
+                    description: 'Optional case-insensitive match on member name or email.',
+                    example: 'Taylor',
+                    minLength: 1,
+                },
+                page: {
+                    type: 'integer',
+                    description: 'Page number (1-indexed).',
+                    default: 1,
+                    minimum: 1,
+                    example: 1,
+                },
+                pageSize: {
+                    type: 'integer',
+                    description: 'Number of results per page (max 100).',
+                    default: 25,
+                    minimum: 1,
+                    maximum: 100,
+                    example: 50,
+                },
+            },
+            additionalProperties: false,
+        },
+        annotations: {
+            readOnlyHint: true,
+            idempotentHint: true,
+        },
+    },
+    {
+        name: 'search-workspace-members',
+        description: formatToolDescription({
+            capability: 'Search workspace members by name, email, or access role.',
+            boundaries: 'modify member profiles or permissions; lookup only.',
+            constraints: 'Requires query string (minimum 2 characters).',
+            recoveryHint: 'If no results, list-workspace-members provides the full roster.',
+        }),
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'Search term for member name, email address, or role.',
+                    minLength: 2,
+                    example: 'operations lead',
+                },
+            },
+            required: ['query'],
+            additionalProperties: false,
+        },
+        annotations: {
+            readOnlyHint: true,
+            idempotentHint: true,
+        },
+    },
+    {
+        name: 'get-workspace-member',
+        description: formatToolDescription({
+            capability: 'Retrieve profile and access details for one workspace member.',
+            boundaries: 'update member information or change permissions.',
+            constraints: 'Requires workspace_member_id from list/search results; read-only.',
+            recoveryHint: 'Use list-workspace-members to confirm the memberId before retrying.',
+        }),
+        inputSchema: {
+            type: 'object',
+            properties: {
+                memberId: {
+                    type: 'string',
+                    description: 'Workspace member ID (UUID).',
+                    example: '550e8400-e29b-41d4-a716-446655440000',
+                },
+            },
+            required: ['memberId'],
+            additionalProperties: false,
+        },
+        annotations: {
+            readOnlyHint: true,
+            idempotentHint: true,
+        },
+    },
+];
+//# sourceMappingURL=workspace-members.js.map

package/dist/handlers/tool-configs/workspace-members.js.map

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

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

@@ -0,0 +1,56 @@
+/**
+ * Common types for tool configurations
+ */
+import { Request, Response } from 'express';
+import { AttioRecord, AttioNote, AttioList, AttioListEntry } from '../types/attio.js';
+import { ListEntryFilters } from '../api/operations/index.js';
+export interface ToolConfig {
+    name: string;
+    handler: any;
+    formatResult?: (results: any) => string;
+    /**
+     * Optional function to return normalized structured data alongside text.
+     * When defined, dispatcher returns dual content:
+     * - content[0]: JSON.stringify(structuredOutput result) - for programmatic parsing
+     * - content[1]: formatResult text - for human readability
+     * This enables tests and clients to receive structured JSON without breaking
+     * the existing string-only formatResult contract.
+     */
+    structuredOutput?: (results: any, resourceType?: string) => Record<string, unknown>;
+}
+export interface SearchToolConfig extends ToolConfig {
+    handler: (query: string) => Promise<AttioRecord[]>;
+    formatResult: (results: AttioRecord[]) => string;
+}
+export interface AdvancedSearchToolConfig extends ToolConfig {
+    handler: (filters: ListEntryFilters, limit?: number, offset?: number) => Promise<AttioRecord[]>;
+    formatResult: (results: AttioRecord[]) => string;
+}
+export interface DetailsToolConfig extends ToolConfig {
+    handler: (id: string) => Promise<AttioRecord>;
+}
+export interface NotesToolConfig extends ToolConfig {
+    handler: (id: string, limit?: number, offset?: number) => Promise<AttioNote[]>;
+}
+export interface CreateNoteToolConfig extends ToolConfig {
+    handler: (id: string, title: string, content: string) => Promise<AttioNote>;
+    idParam?: string;
+}
+export interface GetListsToolConfig extends ToolConfig {
+    handler: () => Promise<AttioList[]>;
+}
+export interface GetListEntriesToolConfig extends ToolConfig {
+    handler: (listId: string) => Promise<AttioListEntry[]>;
+}
+export interface ListActionToolConfig extends ToolConfig {
+    handler: (listId: string, recordId: string) => Promise<AttioRecord | AttioListEntry>;
+    idParams?: string[];
+}
+export interface PromptsToolConfig extends ToolConfig {
+    handler: (req: Request, res: Response) => Promise<void>;
+}
+export interface DateBasedSearchToolConfig extends ToolConfig {
+    handler: (...args: unknown[]) => Promise<AttioRecord[]>;
+    formatResult: (results: AttioRecord[]) => string;
+}
+//# sourceMappingURL=tool-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool-types.d.ts","sourceRoot":"","sources":["../../src/handlers/tool-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EACL,WAAW,EACX,SAAS,EACT,SAAS,EACT,cAAc,EACf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAG9D,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IAEb,OAAO,EAAE,GAAG,CAAC;IAEb,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,MAAM,CAAC;IACxC;;;;;;;OAOG;IAEH,gBAAgB,CAAC,EAAE,CACjB,OAAO,EAAE,GAAG,EACZ,YAAY,CAAC,EAAE,MAAM,KAClB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9B;AAGD,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IAClD,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACnD,YAAY,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,MAAM,CAAC;CAClD;AAGD,MAAM,WAAW,wBAAyB,SAAQ,UAAU;IAC1D,OAAO,EAAE,CACP,OAAO,EAAE,gBAAgB,EACzB,KAAK,CAAC,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,KACZ,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC5B,YAAY,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,MAAM,CAAC;CAClD;AAGD,MAAM,WAAW,iBAAkB,SAAQ,UAAU;IACnD,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;CAC/C;AAGD,MAAM,WAAW,eAAgB,SAAQ,UAAU;IACjD,OAAO,EAAE,CACP,EAAE,EAAE,MAAM,EACV,KAAK,CAAC,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,KACZ,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;CAC3B;AAGD,MAAM,WAAW,oBAAqB,SAAQ,UAAU;IACtD,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAGD,MAAM,WAAW,kBAAmB,SAAQ,UAAU;IACpD,OAAO,EAAE,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;CACrC;AAGD,MAAM,WAAW,wBAAyB,SAAQ,UAAU;IAC1D,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;CACxD;AAGD,MAAM,WAAW,oBAAqB,SAAQ,UAAU;IACtD,OAAO,EAAE,CACP,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,KACb,OAAO,CAAC,WAAW,GAAG,cAAc,CAAC,CAAC;IAC3C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAGD,MAAM,WAAW,iBAAkB,SAAQ,UAAU;IACnD,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzD;AAGD,MAAM,WAAW,yBAA0B,SAAQ,UAAU;IAC3D,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACxD,YAAY,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,MAAM,CAAC;CAClD"}

package/dist/handlers/tool-types.js

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