attio-mcp 0.1.1 → 1.0.0

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

@@ -0,0 +1,319 @@
+/**
+ * Universal tool type definitions for consolidated MCP operations
+ *
+ * These types support the universal tool consolidation effort to reduce
+ * tool count from 70 to ~30 tools while maintaining full functionality.
+ */
+import { AttioRecord } from '../../../types/attio.js';
+import { ToolConfig } from '../../tool-types.js';
+import { ListEntryFilters } from '../../../api/operations/index.js';
+/**
+ * Supported resource types for universal operations
+ */
+export declare enum UniversalResourceType {
+    COMPANIES = "companies",
+    PEOPLE = "people",
+    LISTS = "lists",
+    RECORDS = "records",
+    TASKS = "tasks",
+    DEALS = "deals",
+    NOTES = "notes"
+}
+/**
+ * Information types for detailed info retrieval
+ */
+export declare enum DetailedInfoType {
+    CONTACT = "contact",
+    BUSINESS = "business",
+    SOCIAL = "social",
+    BASIC = "basic",
+    CUSTOM = "custom"
+}
+/**
+ * Universal note creation parameters
+ */
+export interface UniversalCreateNoteParams {
+    resource_type: UniversalResourceType;
+    record_id: string;
+    title: string;
+    content: string;
+    format?: 'markdown' | 'plaintext';
+    created_at?: string;
+}
+/**
+ * Universal get notes parameters
+ */
+export interface UniversalGetNotesParams {
+    resource_type?: UniversalResourceType;
+    record_id?: string;
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Universal update note parameters
+ */
+export interface UniversalUpdateNoteParams {
+    note_id: string;
+    title?: string;
+    content?: string;
+    is_archived?: boolean;
+}
+/**
+ * Universal search notes parameters
+ */
+export interface UniversalSearchNotesParams {
+    resource_type?: UniversalResourceType;
+    record_id?: string;
+    query?: string;
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Universal delete note parameters
+ */
+export interface UniversalDeleteNoteParams {
+    note_id: string;
+}
+/**
+ * Operation types for batch operations
+ */
+export declare enum BatchOperationType {
+    CREATE = "create",
+    UPDATE = "update",
+    DELETE = "delete",
+    SEARCH = "search",
+    GET = "get"
+}
+/**
+ * Temporal filter types for timeframe searches
+ */
+export declare enum TimeframeType {
+    CREATED = "created",
+    MODIFIED = "modified",
+    LAST_INTERACTION = "last_interaction"
+}
+/**
+ * Content search types for content-based searches
+ */
+export declare enum ContentSearchType {
+    NOTES = "notes",
+    ACTIVITY = "activity",
+    INTERACTIONS = "interactions"
+}
+/**
+ * Relationship search types for cross-entity searches
+ */
+export declare enum RelationshipType {
+    COMPANY_TO_PEOPLE = "company_to_people",
+    PEOPLE_TO_COMPANY = "people_to_company",
+    PERSON_TO_TASKS = "person_to_tasks",
+    COMPANY_TO_TASKS = "company_to_tasks",
+    COMPANY_TO_DEALS = "company_to_deals",
+    PERSON_TO_DEALS = "person_to_deals"
+}
+/**
+ * Search type options for different search modes
+ */
+export declare enum SearchType {
+    BASIC = "basic",
+    CONTENT = "content",
+    RELATIONSHIP = "relationship",
+    TIMEFRAME = "timeframe"
+}
+/**
+ * Match type options for search matching
+ */
+export declare enum MatchType {
+    EXACT = "exact",
+    PARTIAL = "partial",
+    FUZZY = "fuzzy"
+}
+/**
+ * Sort options for search results
+ */
+export declare enum SortType {
+    RELEVANCE = "relevance",
+    CREATED = "created",
+    MODIFIED = "modified",
+    NAME = "name"
+}
+/**
+ * Relative timeframe options for date filtering (Issue #475)
+ * Updated to match sales playbook requirements and schema enum values
+ */
+export type RelativeTimeframe = 'today' | 'yesterday' | 'this_week' | 'last_week' | 'this_month' | 'last_month' | 'last_7_days' | 'last_14_days' | 'last_30_days' | 'last_90_days';
+/**
+ * Date field options for timeframe filtering
+ */
+export type DateField = 'created_at' | 'updated_at' | 'due_date';
+/**
+ * Universal search parameters
+ */
+export interface UniversalSearchParams {
+    resource_type: UniversalResourceType;
+    query?: string;
+    filters?: ListEntryFilters;
+    limit?: number;
+    offset?: number;
+    search_type?: SearchType;
+    fields?: string[];
+    match_type?: MatchType;
+    sort?: SortType;
+    relationship_target_type?: UniversalResourceType;
+    relationship_target_id?: string;
+    timeframe_attribute?: string;
+    start_date?: string;
+    end_date?: string;
+    date_operator?: 'greater_than' | 'less_than' | 'between' | 'equals';
+    content_fields?: string[];
+    use_or_logic?: boolean;
+    date_from?: string;
+    date_to?: string;
+    created_after?: string;
+    created_before?: string;
+    updated_after?: string;
+    updated_before?: string;
+    timeframe?: RelativeTimeframe;
+    date_field?: 'created_at' | 'updated_at';
+}
+/**
+ * Universal record details parameters
+ */
+export interface UniversalRecordDetailsParams {
+    resource_type: UniversalResourceType;
+    record_id: string;
+    fields?: string[];
+}
+/**
+ * Universal create record parameters
+ */
+export interface UniversalCreateParams {
+    resource_type: UniversalResourceType;
+    record_data: Record<string, unknown>;
+    return_details?: boolean;
+}
+/**
+ * Universal update record parameters
+ */
+export interface UniversalUpdateParams {
+    resource_type: UniversalResourceType;
+    record_id: string;
+    record_data: Record<string, unknown>;
+    return_details?: boolean;
+}
+/**
+ * Universal delete record parameters
+ */
+export interface UniversalDeleteParams {
+    resource_type: UniversalResourceType;
+    record_id: string;
+}
+/**
+ * Universal attributes parameters
+ */
+export interface UniversalAttributesParams {
+    resource_type: UniversalResourceType;
+    record_id?: string;
+    categories?: string[];
+    fields?: string[];
+}
+/**
+ * Universal detailed info parameters
+ */
+export interface UniversalDetailedInfoParams {
+    resource_type: UniversalResourceType;
+    record_id: string;
+}
+/**
+ * Advanced search parameters
+ */
+export interface AdvancedSearchParams {
+    resource_type: UniversalResourceType;
+    query?: string;
+    filters?: ListEntryFilters;
+    sort_by?: string;
+    sort_order?: 'asc' | 'desc';
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Relationship search parameters
+ */
+export interface RelationshipSearchParams {
+    relationship_type: RelationshipType;
+    source_id: string;
+    target_resource_type?: UniversalResourceType;
+    listId?: string;
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Content search parameters
+ */
+export interface ContentSearchParams {
+    resource_type: UniversalResourceType;
+    content_type: ContentSearchType;
+    search_query: string;
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Timeframe search parameters
+ */
+export interface TimeframeSearchParams {
+    resource_type: UniversalResourceType;
+    timeframe_type?: TimeframeType;
+    start_date?: string;
+    end_date?: string;
+    relative_range?: string;
+    invert_range?: boolean;
+    date_field?: 'created_at' | 'updated_at' | 'modified_at';
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Batch operations parameters
+ */
+export interface BatchOperationsParams {
+    resource_type: UniversalResourceType;
+    operations?: Array<{
+        operation: 'create' | 'update' | 'delete';
+        record_data: Record<string, unknown>;
+    }>;
+    operation_type?: BatchOperationType;
+    records?: Array<Record<string, unknown>>;
+    record_ids?: string[];
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Universal tool configuration interface with proper type safety
+ * @template TParams - The expected parameter type for the handler
+ * @template TResult - The expected result type from the handler
+ */
+export interface UniversalToolConfig<TParams = Record<string, unknown>, TResult = unknown> extends ToolConfig {
+    handler: (params: TParams) => Promise<TResult>;
+    formatResult: (results: TResult, ...args: unknown[]) => string;
+}
+/**
+ * Resource type handler mapping interface
+ */
+export interface ResourceTypeHandler {
+    [UniversalResourceType.COMPANIES]: (params: Record<string, unknown>) => Promise<unknown>;
+    [UniversalResourceType.PEOPLE]: (params: Record<string, unknown>) => Promise<unknown>;
+    [UniversalResourceType.LISTS]: (params: Record<string, unknown>) => Promise<unknown>;
+    [UniversalResourceType.RECORDS]: (params: Record<string, unknown>) => Promise<unknown>;
+    [UniversalResourceType.TASKS]: (params: Record<string, unknown>) => Promise<unknown>;
+}
+/**
+ * Universal tool result formatting interface
+ */
+export interface UniversalResultFormatter {
+    formatSearch: (results: AttioRecord[], resourceType: UniversalResourceType) => string;
+    formatDetails: (record: AttioRecord, resourceType: UniversalResourceType) => string;
+    formatCreate: (record: AttioRecord, resourceType: UniversalResourceType) => string;
+    formatUpdate: (record: AttioRecord, resourceType: UniversalResourceType) => string;
+    formatDelete: (success: boolean, recordId: string, resourceType: UniversalResourceType) => string;
+    formatAttributes: (attributes: Record<string, unknown>, resourceType: UniversalResourceType) => string;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/handlers/tool-configs/universal/types.js

@@ -0,0 +1,101 @@
+/**
+ * Universal tool type definitions for consolidated MCP operations
+ *
+ * These types support the universal tool consolidation effort to reduce
+ * tool count from 70 to ~30 tools while maintaining full functionality.
+ */
+/**
+ * Supported resource types for universal operations
+ */
+export var UniversalResourceType;
+(function (UniversalResourceType) {
+    UniversalResourceType["COMPANIES"] = "companies";
+    UniversalResourceType["PEOPLE"] = "people";
+    UniversalResourceType["LISTS"] = "lists";
+    UniversalResourceType["RECORDS"] = "records";
+    UniversalResourceType["TASKS"] = "tasks";
+    UniversalResourceType["DEALS"] = "deals";
+    UniversalResourceType["NOTES"] = "notes";
+})(UniversalResourceType || (UniversalResourceType = {}));
+/**
+ * Information types for detailed info retrieval
+ */
+export var DetailedInfoType;
+(function (DetailedInfoType) {
+    DetailedInfoType["CONTACT"] = "contact";
+    DetailedInfoType["BUSINESS"] = "business";
+    DetailedInfoType["SOCIAL"] = "social";
+    DetailedInfoType["BASIC"] = "basic";
+    DetailedInfoType["CUSTOM"] = "custom";
+})(DetailedInfoType || (DetailedInfoType = {}));
+/**
+ * Operation types for batch operations
+ */
+export var BatchOperationType;
+(function (BatchOperationType) {
+    BatchOperationType["CREATE"] = "create";
+    BatchOperationType["UPDATE"] = "update";
+    BatchOperationType["DELETE"] = "delete";
+    BatchOperationType["SEARCH"] = "search";
+    BatchOperationType["GET"] = "get";
+})(BatchOperationType || (BatchOperationType = {}));
+/**
+ * Temporal filter types for timeframe searches
+ */
+export var TimeframeType;
+(function (TimeframeType) {
+    TimeframeType["CREATED"] = "created";
+    TimeframeType["MODIFIED"] = "modified";
+    TimeframeType["LAST_INTERACTION"] = "last_interaction";
+})(TimeframeType || (TimeframeType = {}));
+/**
+ * Content search types for content-based searches
+ */
+export var ContentSearchType;
+(function (ContentSearchType) {
+    ContentSearchType["NOTES"] = "notes";
+    ContentSearchType["ACTIVITY"] = "activity";
+    ContentSearchType["INTERACTIONS"] = "interactions";
+})(ContentSearchType || (ContentSearchType = {}));
+/**
+ * Relationship search types for cross-entity searches
+ */
+export var RelationshipType;
+(function (RelationshipType) {
+    RelationshipType["COMPANY_TO_PEOPLE"] = "company_to_people";
+    RelationshipType["PEOPLE_TO_COMPANY"] = "people_to_company";
+    RelationshipType["PERSON_TO_TASKS"] = "person_to_tasks";
+    RelationshipType["COMPANY_TO_TASKS"] = "company_to_tasks";
+    RelationshipType["COMPANY_TO_DEALS"] = "company_to_deals";
+    RelationshipType["PERSON_TO_DEALS"] = "person_to_deals";
+})(RelationshipType || (RelationshipType = {}));
+/**
+ * Search type options for different search modes
+ */
+export var SearchType;
+(function (SearchType) {
+    SearchType["BASIC"] = "basic";
+    SearchType["CONTENT"] = "content";
+    SearchType["RELATIONSHIP"] = "relationship";
+    SearchType["TIMEFRAME"] = "timeframe";
+})(SearchType || (SearchType = {}));
+/**
+ * Match type options for search matching
+ */
+export var MatchType;
+(function (MatchType) {
+    MatchType["EXACT"] = "exact";
+    MatchType["PARTIAL"] = "partial";
+    MatchType["FUZZY"] = "fuzzy";
+})(MatchType || (MatchType = {}));
+/**
+ * Sort options for search results
+ */
+export var SortType;
+(function (SortType) {
+    SortType["RELEVANCE"] = "relevance";
+    SortType["CREATED"] = "created";
+    SortType["MODIFIED"] = "modified";
+    SortType["NAME"] = "name";
+})(SortType || (SortType = {}));
+//# sourceMappingURL=types.js.map

package/dist/handlers/tool-configs/universal/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/handlers/tool-configs/universal/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;GAEG;AACH,MAAM,CAAN,IAAY,qBAQX;AARD,WAAY,qBAAqB;IAC/B,gDAAuB,CAAA;IACvB,0CAAiB,CAAA;IACjB,wCAAe,CAAA;IACf,4CAAmB,CAAA;IACnB,wCAAe,CAAA;IACf,wCAAe,CAAA;IACf,wCAAe,CAAA;AACjB,CAAC,EARW,qBAAqB,KAArB,qBAAqB,QAQhC;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,gBAMX;AAND,WAAY,gBAAgB;IAC1B,uCAAmB,CAAA;IACnB,yCAAqB,CAAA;IACrB,qCAAiB,CAAA;IACjB,mCAAe,CAAA;IACf,qCAAiB,CAAA;AACnB,CAAC,EANW,gBAAgB,KAAhB,gBAAgB,QAM3B;AAoDD;;GAEG;AACH,MAAM,CAAN,IAAY,kBAMX;AAND,WAAY,kBAAkB;IAC5B,uCAAiB,CAAA;IACjB,uCAAiB,CAAA;IACjB,uCAAiB,CAAA;IACjB,uCAAiB,CAAA;IACjB,iCAAW,CAAA;AACb,CAAC,EANW,kBAAkB,KAAlB,kBAAkB,QAM7B;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,aAIX;AAJD,WAAY,aAAa;IACvB,oCAAmB,CAAA;IACnB,sCAAqB,CAAA;IACrB,sDAAqC,CAAA;AACvC,CAAC,EAJW,aAAa,KAAb,aAAa,QAIxB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,iBAIX;AAJD,WAAY,iBAAiB;IAC3B,oCAAe,CAAA;IACf,0CAAqB,CAAA;IACrB,kDAA6B,CAAA;AAC/B,CAAC,EAJW,iBAAiB,KAAjB,iBAAiB,QAI5B;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,gBAOX;AAPD,WAAY,gBAAgB;IAC1B,2DAAuC,CAAA;IACvC,2DAAuC,CAAA;IACvC,uDAAmC,CAAA;IACnC,yDAAqC,CAAA;IACrC,yDAAqC,CAAA;IACrC,uDAAmC,CAAA;AACrC,CAAC,EAPW,gBAAgB,KAAhB,gBAAgB,QAO3B;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,UAKX;AALD,WAAY,UAAU;IACpB,6BAAe,CAAA;IACf,iCAAmB,CAAA;IACnB,2CAA6B,CAAA;IAC7B,qCAAuB,CAAA;AACzB,CAAC,EALW,UAAU,KAAV,UAAU,QAKrB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,SAIX;AAJD,WAAY,SAAS;IACnB,4BAAe,CAAA;IACf,gCAAmB,CAAA;IACnB,4BAAe,CAAA;AACjB,CAAC,EAJW,SAAS,KAAT,SAAS,QAIpB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,QAKX;AALD,WAAY,QAAQ;IAClB,mCAAuB,CAAA;IACvB,+BAAmB,CAAA;IACnB,iCAAqB,CAAA;IACrB,yBAAa,CAAA;AACf,CAAC,EALW,QAAQ,KAAR,QAAQ,QAKnB"}

package/dist/handlers/tool-configs/universal/validators/cross-resource-validator.d.ts

@@ -0,0 +1,14 @@
+import { UniversalResourceType } from '../types.js';
+import { HttpStatusCode } from '../errors/validation-errors.js';
+export declare class CrossResourceValidator {
+    static validateCompanyExists(companyId: string): Promise<{
+        exists: boolean;
+        error?: {
+            type: 'not_found' | 'api_error' | 'invalid_format';
+            message: string;
+            httpStatusCode: HttpStatusCode;
+        };
+    }>;
+    static validateRecordRelationships(resourceType: UniversalResourceType, recordData: Record<string, unknown> | null | undefined): Promise<void>;
+}
+//# sourceMappingURL=cross-resource-validator.d.ts.map

package/dist/handlers/tool-configs/universal/validators/cross-resource-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-resource-validator.d.ts","sourceRoot":"","sources":["../../../../../src/handlers/tool-configs/universal/validators/cross-resource-validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAEL,cAAc,EAEf,MAAM,gCAAgC,CAAC;AAGxC,qBAAa,sBAAsB;WACpB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAC7D,MAAM,EAAE,OAAO,CAAC;QAChB,KAAK,CAAC,EAAE;YACN,IAAI,EAAE,WAAW,GAAG,WAAW,GAAG,gBAAgB,CAAC;YACnD,OAAO,EAAE,MAAM,CAAC;YAChB,cAAc,EAAE,cAAc,CAAC;SAChC,CAAC;KACH,CAAC;WAsDW,2BAA2B,CACtC,YAAY,EAAE,qBAAqB,EACnC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GACrD,OAAO,CAAC,IAAI,CAAC;CAuDjB"}

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

@@ -0,0 +1,98 @@
+import { UniversalResourceType } from '../types.js';
+import { ErrorType, HttpStatusCode, UniversalValidationError, } from '../errors/validation-errors.js';
+import { getLazyAttioClient } from '../../../../api/lazy-client.js';
+export class CrossResourceValidator {
+    static async validateCompanyExists(companyId) {
+        if (!companyId ||
+            typeof companyId !== 'string' ||
+            companyId.trim().length === 0) {
+            return {
+                exists: false,
+                error: {
+                    type: 'invalid_format',
+                    message: 'Company ID must be a non-empty string',
+                    httpStatusCode: HttpStatusCode.UNPROCESSABLE_ENTITY,
+                },
+            };
+        }
+        try {
+            const client = getLazyAttioClient();
+            await client.get(`/objects/companies/records/${companyId.trim()}`);
+            return { exists: true };
+        }
+        catch (error) {
+            const responseStatus = typeof error === 'object' &&
+                error !== null &&
+                'response' in error &&
+                typeof error.response ===
+                    'object'
+                ? error.response?.status
+                : undefined;
+            if (responseStatus === 404) {
+                return {
+                    exists: false,
+                    error: {
+                        type: 'not_found',
+                        message: `Company with ID '${companyId}' does not exist`,
+                        httpStatusCode: HttpStatusCode.NOT_FOUND,
+                    },
+                };
+            }
+            return {
+                exists: false,
+                error: {
+                    type: 'api_error',
+                    message: `Failed to validate company existence: ${typeof error === 'object' && error !== null && 'message' in error
+                        ? String(error.message)
+                        : 'Unknown API error'}`,
+                    httpStatusCode: HttpStatusCode.BAD_GATEWAY,
+                },
+            };
+        }
+    }
+    static async validateRecordRelationships(resourceType, recordData) {
+        if (!recordData || typeof recordData !== 'object')
+            return;
+        switch (resourceType) {
+            case UniversalResourceType.PEOPLE: {
+                const recordDataObj = recordData;
+                const companyField = recordDataObj.company;
+                const nestedCompanyId = typeof companyField === 'object' &&
+                    companyField !== null &&
+                    'id' in companyField
+                    ? companyField.id
+                    : undefined;
+                const companyId = recordDataObj.company_id ?? nestedCompanyId ?? companyField;
+                if (companyId) {
+                    const companyIdString = String(companyId);
+                    const validationResult = await this.validateCompanyExists(companyIdString);
+                    if (!validationResult.exists) {
+                        const error = validationResult.error;
+                        throw new UniversalValidationError(error.message, error.type === 'api_error'
+                            ? ErrorType.API_ERROR
+                            : ErrorType.USER_ERROR, {
+                            field: 'company_id',
+                            suggestion: error.type === 'not_found'
+                                ? 'Verify the company ID exists, or create the company first'
+                                : 'Check your API connection and try again',
+                            example: error.type === 'not_found'
+                                ? `Try searching for companies first: search-records with resource_type: 'companies'`
+                                : undefined,
+                            httpStatusCode: error.httpStatusCode,
+                        });
+                    }
+                }
+                break;
+            }
+            case UniversalResourceType.RECORDS:
+                // Placeholder for custom record relations validation
+                break;
+            case UniversalResourceType.TASKS:
+                // Placeholder: validate referenced record existence if needed
+                break;
+            default:
+                break;
+        }
+    }
+}
+//# sourceMappingURL=cross-resource-validator.js.map

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

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

package/dist/handlers/tool-configs/universal/validators/field-validator.d.ts

@@ -0,0 +1,5 @@
+import { SanitizedObject } from '../schemas/common/types.js';
+export declare function suggestResourceType(invalid: string): string | undefined;
+export declare function validatePaginationParams(params: SanitizedObject): void;
+export declare function validateIdFields(params: SanitizedObject): void;
+//# sourceMappingURL=field-validator.d.ts.map

package/dist/handlers/tool-configs/universal/validators/field-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-validator.d.ts","sourceRoot":"","sources":["../../../../../src/handlers/tool-configs/universal/validators/field-validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAQ7D,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAwBvE;AA8BD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CA6EtE;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CA2C9D"}