@iflow-mcp/attio-mcp 1.3.6

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"}

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

@@ -0,0 +1,143 @@
+import { UniversalResourceType } from '../types.js';
+import { ErrorType, HttpStatusCode, UniversalValidationError, } from '../errors/validation-errors.js';
+export function suggestResourceType(invalid) {
+    const validTypes = Object.values(UniversalResourceType);
+    const lower = invalid.toLowerCase();
+    const suggestions = {
+        company: 'companies',
+        person: 'people',
+        record: 'records',
+        task: 'tasks',
+        user: 'people',
+        contact: 'people',
+        organization: 'companies',
+        org: 'companies',
+    };
+    if (suggestions[lower])
+        return suggestions[lower];
+    let bestMatch = '';
+    let bestScore = 0;
+    for (const validType of validTypes) {
+        const score = getStringSimilarity(lower, validType);
+        if (score > bestScore && score > 0.5) {
+            bestScore = score;
+            bestMatch = validType;
+        }
+    }
+    return bestMatch || undefined;
+}
+function getStringSimilarity(str1, str2) {
+    const longer = str1.length > str2.length ? str1 : str2;
+    const shorter = str1.length > str2.length ? str2 : str1;
+    if (longer.length === 0)
+        return 1.0;
+    const editDistance = getEditDistance(longer, shorter);
+    return (longer.length - editDistance) / longer.length;
+}
+function getEditDistance(str1, str2) {
+    const matrix = [];
+    for (let i = 0; i <= str2.length; i++)
+        matrix[i] = [i];
+    for (let j = 0; j <= str1.length; j++)
+        matrix[0][j] = j;
+    for (let i = 1; i <= str2.length; i++) {
+        for (let j = 1; j <= str1.length; j++) {
+            if (str2.charAt(i - 1) === str1.charAt(j - 1)) {
+                matrix[i][j] = matrix[i - 1][j - 1];
+            }
+            else {
+                matrix[i][j] = Math.min(matrix[i - 1][j - 1] + 1, matrix[i][j - 1] + 1, matrix[i - 1][j] + 1);
+            }
+        }
+    }
+    return matrix[str2.length][str1.length];
+}
+export function validatePaginationParams(params) {
+    if ('limit' in params &&
+        params.limit !== null &&
+        params.limit !== undefined) {
+        const limit = Number(params.limit);
+        if (isNaN(limit) || !Number.isInteger(limit)) {
+            throw new UniversalValidationError('Parameter "limit" must be an integer', ErrorType.USER_ERROR, {
+                field: 'limit',
+                httpStatusCode: HttpStatusCode.UNPROCESSABLE_ENTITY,
+                suggestion: 'Provide a valid integer for limit',
+                example: 'limit: 10',
+            });
+        }
+        if (limit < 1) {
+            throw new UniversalValidationError('Parameter "limit" must be at least 1', ErrorType.USER_ERROR, {
+                field: 'limit',
+                httpStatusCode: HttpStatusCode.UNPROCESSABLE_ENTITY,
+                suggestion: 'Use a positive integer for limit',
+                example: 'limit: 10',
+            });
+        }
+        if (limit > 100) {
+            throw new UniversalValidationError('Parameter "limit" must not exceed 100', ErrorType.USER_ERROR, {
+                field: 'limit',
+                httpStatusCode: HttpStatusCode.UNPROCESSABLE_ENTITY,
+                suggestion: 'Use a value between 1 and 100',
+                example: 'limit: 50',
+            });
+        }
+        params.limit = limit;
+    }
+    if ('offset' in params &&
+        params.offset !== null &&
+        params.offset !== undefined) {
+        const offset = Number(params.offset);
+        if (isNaN(offset) || !Number.isInteger(offset)) {
+            throw new UniversalValidationError('Parameter "offset" must be an integer', ErrorType.USER_ERROR, {
+                field: 'offset',
+                httpStatusCode: HttpStatusCode.UNPROCESSABLE_ENTITY,
+                suggestion: 'Provide a valid integer for offset',
+                example: 'offset: 0',
+            });
+        }
+        if (offset < 0) {
+            throw new UniversalValidationError('Parameter "offset" must be non-negative', ErrorType.USER_ERROR, {
+                field: 'offset',
+                httpStatusCode: HttpStatusCode.UNPROCESSABLE_ENTITY,
+                suggestion: 'Use a non-negative integer for offset',
+                example: 'offset: 0',
+            });
+        }
+        params.offset = offset;
+    }
+}
+export function validateIdFields(params) {
+    const idFields = [
+        'record_id',
+        'source_id',
+        'target_id',
+        'company_id',
+        'person_id',
+        'list_id',
+    ];
+    for (const field of idFields) {
+        if (field in params &&
+            params[field] !== null &&
+            params[field] !== undefined) {
+            const id = String(params[field]);
+            const idRegex = /^[a-zA-Z0-9_-]+$/;
+            if (!idRegex.test(id)) {
+                throw new UniversalValidationError(`Invalid ${field} format: "${id}"`, ErrorType.USER_ERROR, {
+                    field,
+                    httpStatusCode: HttpStatusCode.UNPROCESSABLE_ENTITY,
+                    suggestion: `The ${field} should contain only letters, numbers, underscores, and hyphens`,
+                    example: `${field}: 'comp_abc123' or 'person_xyz789'`,
+                });
+            }
+            if (id.length < 3 || id.length > 100) {
+                throw new UniversalValidationError(`Invalid ${field} length: ${id.length} characters`, ErrorType.USER_ERROR, {
+                    field,
+                    httpStatusCode: HttpStatusCode.UNPROCESSABLE_ENTITY,
+                    suggestion: `The ${field} should be between 3 and 100 characters`,
+                    example: `${field}: 'comp_abc123'`,
+                });
+            }
+        }
+    }
+}
+//# sourceMappingURL=field-validator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"field-validator.js","sourceRoot":"","sources":["../../../../../src/handlers/tool-configs/universal/validators/field-validator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EACL,SAAS,EACT,cAAc,EACd,wBAAwB,GACzB,MAAM,gCAAgC,CAAC;AAExC,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;IACxD,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACpC,MAAM,WAAW,GAA2B;QAC1C,OAAO,EAAE,WAAW;QACpB,MAAM,EAAE,QAAQ;QAChB,MAAM,EAAE,SAAS;QACjB,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,QAAQ;QACjB,YAAY,EAAE,WAAW;QACzB,GAAG,EAAE,WAAW;KACjB,CAAC;IACF,IAAI,WAAW,CAAC,KAAK,CAAC;QAAE,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;IAClD,IAAI,SAAS,GAAG,EAAE,CAAC;IACnB,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,mBAAmB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QACpD,IAAI,KAAK,GAAG,SAAS,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;YACrC,SAAS,GAAG,KAAK,CAAC;YAClB,SAAS,GAAG,SAAS,CAAC;QACxB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,IAAI,SAAS,CAAC;AAChC,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAY,EAAE,IAAY;IACrD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACvD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACxD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IACpC,MAAM,YAAY,GAAG,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtD,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,YAAY,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;AACxD,CAAC;AAED,SAAS,eAAe,CAAC,IAAY,EAAE,IAAY;IACjD,MAAM,MAAM,GAAe,EAAE,CAAC;IAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACvD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACxD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;gBAC9C,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACtC,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CACrB,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EACxB,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EACpB,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CACrB,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,MAAuB;IAC9D,IACE,OAAO,IAAI,MAAM;QACjB,MAAM,CAAC,KAAK,KAAK,IAAI;QACrB,MAAM,CAAC,KAAK,KAAK,SAAS,EAC1B,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7C,MAAM,IAAI,wBAAwB,CAChC,sCAAsC,EACtC,SAAS,CAAC,UAAU,EACpB;gBACE,KAAK,EAAE,OAAO;gBACd,cAAc,EAAE,cAAc,CAAC,oBAAoB;gBACnD,UAAU,EAAE,mCAAmC;gBAC/C,OAAO,EAAE,WAAW;aACrB,CACF,CAAC;QACJ,CAAC;QACD,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACd,MAAM,IAAI,wBAAwB,CAChC,sCAAsC,EACtC,SAAS,CAAC,UAAU,EACpB;gBACE,KAAK,EAAE,OAAO;gBACd,cAAc,EAAE,cAAc,CAAC,oBAAoB;gBACnD,UAAU,EAAE,kCAAkC;gBAC9C,OAAO,EAAE,WAAW;aACrB,CACF,CAAC;QACJ,CAAC;QACD,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;YAChB,MAAM,IAAI,wBAAwB,CAChC,uCAAuC,EACvC,SAAS,CAAC,UAAU,EACpB;gBACE,KAAK,EAAE,OAAO;gBACd,cAAc,EAAE,cAAc,CAAC,oBAAoB;gBACnD,UAAU,EAAE,+BAA+B;gBAC3C,OAAO,EAAE,WAAW;aACrB,CACF,CAAC;QACJ,CAAC;QACD,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC;IACD,IACE,QAAQ,IAAI,MAAM;QAClB,MAAM,CAAC,MAAM,KAAK,IAAI;QACtB,MAAM,CAAC,MAAM,KAAK,SAAS,EAC3B,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACrC,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/C,MAAM,IAAI,wBAAwB,CAChC,uCAAuC,EACvC,SAAS,CAAC,UAAU,EACpB;gBACE,KAAK,EAAE,QAAQ;gBACf,cAAc,EAAE,cAAc,CAAC,oBAAoB;gBACnD,UAAU,EAAE,oCAAoC;gBAChD,OAAO,EAAE,WAAW;aACrB,CACF,CAAC;QACJ,CAAC;QACD,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;YACf,MAAM,IAAI,wBAAwB,CAChC,yCAAyC,EACzC,SAAS,CAAC,UAAU,EACpB;gBACE,KAAK,EAAE,QAAQ;gBACf,cAAc,EAAE,cAAc,CAAC,oBAAoB;gBACnD,UAAU,EAAE,uCAAuC;gBACnD,OAAO,EAAE,WAAW;aACrB,CACF,CAAC;QACJ,CAAC;QACD,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAuB;IACtD,MAAM,QAAQ,GAAG;QACf,WAAW;QACX,WAAW;QACX,WAAW;QACX,YAAY;QACZ,WAAW;QACX,SAAS;KACV,CAAC;IACF,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,IACE,KAAK,IAAI,MAAM;YACf,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI;YACtB,MAAM,CAAC,KAAK,CAAC,KAAK,SAAS,EAC3B,CAAC;YACD,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACjC,MAAM,OAAO,GAAG,kBAAkB,CAAC;YACnC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;gBACtB,MAAM,IAAI,wBAAwB,CAChC,WAAW,KAAK,aAAa,EAAE,GAAG,EAClC,SAAS,CAAC,UAAU,EACpB;oBACE,KAAK;oBACL,cAAc,EAAE,cAAc,CAAC,oBAAoB;oBACnD,UAAU,EAAE,OAAO,KAAK,iEAAiE;oBACzF,OAAO,EAAE,GAAG,KAAK,oCAAoC;iBACtD,CACF,CAAC;YACJ,CAAC;YACD,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;gBACrC,MAAM,IAAI,wBAAwB,CAChC,WAAW,KAAK,YAAY,EAAE,CAAC,MAAM,aAAa,EAClD,SAAS,CAAC,UAAU,EACpB;oBACE,KAAK;oBACL,cAAc,EAAE,cAAc,CAAC,oBAAoB;oBACnD,UAAU,EAAE,OAAO,KAAK,yCAAyC;oBACjE,OAAO,EAAE,GAAG,KAAK,iBAAiB;iBACnC,CACF,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,8 @@
+import { SanitizedValue } from '../schemas/common/types.js';
+export declare class InputSanitizer {
+    static sanitizeString(input: unknown): string;
+    static normalizeEmail(email: unknown): string;
+    static sanitizeObject(obj: unknown): SanitizedValue;
+}
+export declare function validateUniversalToolParams(toolName: string, params: any): any;
+//# sourceMappingURL=schema-validator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema-validator.d.ts","sourceRoot":"","sources":["../../../../../src/handlers/tool-configs/universal/validators/schema-validator.ts"],"names":[],"mappings":"AAMA,OAAO,EAAmB,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAO7E,qBAAa,cAAc;IACzB,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM;IAW7C,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM;IAO7C,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc;CAwCpD;AAsWD,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,MAAM,EAEhB,MAAM,EAAE,GAAG,GACV,GAAG,CA4CL"}