attio-mcp 1.0.0 → 1.1.1

package/dist/handlers/tool-configs/universal/batch-search.js

@@ -8,6 +8,7 @@ import { formatResourceType } from './shared-handlers.js';
 // Import ErrorService for error handling
 import { ErrorService } from '../../../services/ErrorService.js';
 import { validateBatchOperation } from '../../../utils/batch-validation.js';
+import { formatToolDescription } from '../../../handlers/tools/standards/index.js';
 // Import enhanced batch API for optimized performance (Issue #471)
 import { universalBatchSearch, } from '../../../api/operations/batch.js';
 /**
@@ -16,10 +17,10 @@ import { universalBatchSearch, } from '../../../api/operations/batch.js';
  * Enhanced for Issue #471 with optimized batch API
  */
 export const batchSearchConfig = {
-    name: 'batch-search',
+    name: 'records_search_batch',
     handler: async (params) => {
         try {
-            const sanitizedParams = validateUniversalToolParams('batch-search', params);
+            const sanitizedParams = validateUniversalToolParams('records_search_batch', params);
             const { resource_type, queries, limit, offset } = sanitizedParams;
             if (!queries || !Array.isArray(queries) || queries.length === 0) {
                 throw new Error('Queries array is required and must not be empty');
@@ -41,7 +42,7 @@ export const batchSearchConfig = {
             });
         }
         catch (error) {
-            throw ErrorService.createUniversalError('batch search', params.resource_type, error);
+            throw ErrorService.createUniversalError('records_search_batch', params.resource_type, error);
         }
     },
     formatResult: (results, resourceType) => {
@@ -138,13 +139,25 @@ export const batchSearchSchema = {
     },
     required: ['resource_type', 'queries'],
     additionalProperties: false,
+    examples: [
+        {
+            resource_type: 'companies',
+            queries: ['Acme', 'Globex'],
+            limit: 10,
+        },
+    ],
 };
 /**
  * Batch search tool definition for MCP protocol
  */
 export const batchSearchToolDefinition = {
-    name: 'batch-search',
-    description: 'Perform batch search operations with multiple queries in parallel',
+    name: 'records_search_batch',
+    description: formatToolDescription({
+        capability: 'Execute multiple searches in parallel and return grouped results.',
+        boundaries: 'mutate or import data; use records.batch for write operations.',
+        constraints: 'Provide queries array (1–10 items recommended) and resource_type.',
+        recoveryHint: 'If queries fail, retry individually using records.search.',
+    }),
     inputSchema: batchSearchSchema,
     annotations: {
         readOnlyHint: true,

package/dist/handlers/tool-configs/universal/batch-search.js.map

@@ -1 +1 @@
-{"version":3,"file":"batch-search.js","sourceRoot":"","sources":["../../../../src/handlers/tool-configs/universal/batch-search.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"batch-search.js","sourceRoot":"","sources":["../../../../src/handlers/tool-configs/universal/batch-search.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAuB,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExE,OAAO,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAE3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,yCAAyC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAGjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAE5E,mEAAmE;AACnE,OAAO,EACL,oBAAoB,GAErB,MAAM,kCAAkC,CAAC;AAc1C;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,sBAAsB;IAC5B,OAAO,EAAE,KAAK,EACZ,MAAyB,EACc,EAAE;QACzC,IAAI,CAAC;YACH,MAAM,eAAe,GAAG,2BAA2B,CACjD,sBAAsB,EACtB,MAAM,CACP,CAAC;YAEF,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,eAAe,CAAC;YAElE,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAChE,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;YACrE,CAAC;YAED,qDAAqD;YACrD,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;gBAC9C,KAAK,EAAE,OAAO;gBACd,aAAa,EAAE,QAAQ;gBACvB,YAAY,EAAE,aAAa;gBAC3B,YAAY,EAAE,KAAK,EAAE,wCAAwC;aAC9D,CAAC,CAAC;YACH,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC;gBAC9B,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;YAC1C,CAAC;YAED,wDAAwD;YACxD,OAAO,MAAM,oBAAoB,CAAC,aAAa,EAAE,OAAO,EAAE;gBACxD,KAAK;gBACL,MAAM;aACP,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,YAAY,CAAC,oBAAoB,CACrC,sBAAsB,EACtB,MAAM,CAAC,aAAa,EACpB,KAAK,CACN,CAAC;QACJ,CAAC;IACH,CAAC;IACD,YAAY,EAAE,CACZ,OAA+C,EAC/C,YAAoC,EACpC,EAAE;QACF,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACxC,OAAO,4CAA4C,CAAC;QACtD,CAAC;QAED,4DAA4D;QAC5D,MAAM,YAAY,GAAG,OAAuC,CAAC;QAE7D,MAAM,gBAAgB,GAAG,YAAY;YACnC,CAAC,CAAC,kBAAkB,CAAC,YAAY,CAAC;YAClC,CAAC,CAAC,QAAQ,CAAC;QAEb,sEAAsE;QACtE,MAAM,aAAa,GAAG,CAAC,KAAa,EAAE,QAAgB,EAAU,EAAE;YAChE,IAAI,KAAK,KAAK,CAAC;gBAAE,OAAO,QAAQ,CAAC;YACjC,IAAI,QAAQ,KAAK,SAAS;gBAAE,OAAO,WAAW,CAAC;YAC/C,IAAI,QAAQ,KAAK,QAAQ;gBAAE,OAAO,QAAQ,CAAC;YAC3C,OAAO,GAAG,QAAQ,GAAG,CAAC;QACxB,CAAC,CAAC;QAEF,MAAM,YAAY,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;QAClE,MAAM,YAAY,GAAG,YAAY,CAAC,MAAM,GAAG,YAAY,CAAC;QAExD,IAAI,OAAO,GAAG,2BAA2B,YAAY,gBAAgB,YAAY,aAAa,CAAC;QAE/F,iCAAiC;QACjC,MAAM,UAAU,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACzD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,OAAO,IAAI,wBAAwB,CAAC;YACpC,UAAU,CAAC,OAAO,CAChB,CAAC,YAAwC,EAAE,KAAa,EAAE,EAAE;gBAC1D,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC;gBACjC,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,IAAI,EAAE,CAAC;gBAE1C,OAAO,IAAI,KAAK,KAAK,GAAG,CAAC,aAAa,KAAK,aAAa,OAAO,CAAC,MAAM,IAAI,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,gBAAgB,CAAC,IAAI,CAAC;gBAE9H,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACjD,wCAAwC;oBACxC,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;oBACjD,OAAO;yBACJ,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC;yBACtB,OAAO,CAAC,CAAC,MAAmB,EAAE,WAAmB,EAAE,EAAE;wBACpD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAiC,CAAC;wBACxD,MAAM,QAAQ,GAAG,MAAM,CAAC,EAA6B,CAAC;wBACtD,MAAM,IAAI,GACP,MAAM,EAAE,IAAkC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK;4BACtD,MAAM,EAAE,KAAmC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK;4BACxD,SAAS,CAAC;wBACZ,MAAM,EAAE,GAAG,QAAQ,EAAE,SAAS,IAAI,SAAS,CAAC;wBAE5C,OAAO,IAAI,MAAM,WAAW,GAAG,CAAC,KAAK,IAAI,SAAS,EAAE,KAAK,CAAC;oBAC5D,CAAC,CAAC,CAAC;oBAEL,IAAI,OAAO,CAAC,MAAM,GAAG,YAAY,EAAE,CAAC;wBAClC,OAAO,IAAI,cAAc,OAAO,CAAC,MAAM,GAAG,YAAY,SAAS,CAAC;oBAClE,CAAC;gBACH,CAAC;YACH,CAAC,CACF,CAAC;QACJ,CAAC;QAED,kCAAkC;QAClC,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACtD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,OAAO,IAAI,sBAAsB,CAAC;YAClC,MAAM,CAAC,OAAO,CACZ,CAAC,YAAwC,EAAE,KAAa,EAAE,EAAE;gBAC1D,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,IAAI,eAAe,CAAC;gBACpD,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,IAAI,eAAe,CAAC;gBACpD,OAAO,IAAI,GAAG,KAAK,GAAG,CAAC,aAAa,KAAK,cAAc,KAAK,IAAI,CAAC;YACnE,CAAC,CACF,CAAC;QACJ,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;CACgC,CAAC;AAEpC;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,QAAiB;IACvB,UAAU,EAAE;QACV,aAAa,EAAE;YACb,IAAI,EAAE,QAAiB;YACvB,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,qBAAqB,CAAC;YAC1C,WAAW,EACT,oEAAoE;SACvE;QACD,OAAO,EAAE;YACP,IAAI,EAAE,OAAgB;YACtB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;YAClC,WAAW,EAAE,+BAA+B;YAC5C,QAAQ,EAAE,CAAC;SACZ;QACD,KAAK,EAAE;YACL,IAAI,EAAE,QAAiB;YACvB,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,GAAG;YACZ,WAAW,EAAE,mDAAmD;SACjE;QACD,MAAM,EAAE;YACN,IAAI,EAAE,QAAiB;YACvB,OAAO,EAAE,CAAC;YACV,WAAW,EAAE,kDAAkD;SAChE;KACF;IACD,QAAQ,EAAE,CAAC,eAAwB,EAAE,SAAkB,CAAC;IACxD,oBAAoB,EAAE,KAAK;IAC3B,QAAQ,EAAE;QACR;YACE,aAAa,EAAE,WAAW;YAC1B,OAAO,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC;YAC3B,KAAK,EAAE,EAAE;SACV;KACF;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE,qBAAqB,CAAC;QACjC,UAAU,EACR,mEAAmE;QACrE,UAAU,EACR,gEAAgE;QAClE,WAAW,EACT,mEAAmE;QACrE,YAAY,EAAE,2DAA2D;KAC1E,CAAC;IACF,WAAW,EAAE,iBAAiB;IAC9B,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;QAClB,cAAc,EAAE,IAAI;KACrB;CACF,CAAC"}

package/dist/handlers/tool-configs/universal/core/crud-error-handlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"crud-error-handlers.d.ts","sourceRoot":"","sources":["../../../../../src/handlers/tool-configs/universal/core/crud-error-handlers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAmBH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAgBrD;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAC5B,OAAO,OAAO,EACd,cAAc,MAAM,EACpB,YAAY,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAClC,OAAO,CAAC,KAAK,CAgDf,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAC5B,OAAO,OAAO,EACd,cAAc,MAAM,EACpB,YAAY,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,WAAW,MAAM,EACjB,qBAAqB,kBAAkB,KACtC,OAAO,CAAC,KAAK,CA6Df,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAC5B,OAAO,OAAO,EACd,cAAc,MAAM,EACpB,UAAU,MAAM,KACf,OAAO,CAAC,KAAK,CA8Cf,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAC5B,OAAO,OAAO,EACd,cAAc,MAAM,EACpB,eAAe,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KACrC,OAAO,CAAC,KAAK,CAgDf,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,GACnC,OAAO,OAAO,EACd,WACI,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,aAAa,GACb,eAAe,EACnB,cAAc,MAAM,EACpB,aAAa,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,WAAW,MAAM,EACjB,qBAAqB,kBAAkB,KACtC,OAAO,CAAC,KAAK,CAuCf,CAAC"}
+{"version":3,"file":"crud-error-handlers.d.ts","sourceRoot":"","sources":["../../../../../src/handlers/tool-configs/universal/core/crud-error-handlers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAmBH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAoDrD;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAC5B,OAAO,OAAO,EACd,cAAc,MAAM,EACpB,YAAY,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAClC,OAAO,CAAC,KAAK,CAoDf,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAC5B,OAAO,OAAO,EACd,cAAc,MAAM,EACpB,YAAY,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,WAAW,MAAM,EACjB,qBAAqB,kBAAkB,KACtC,OAAO,CAAC,KAAK,CA6Df,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAC5B,OAAO,OAAO,EACd,cAAc,MAAM,EACpB,UAAU,MAAM,KACf,OAAO,CAAC,KAAK,CA8Cf,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAC5B,OAAO,OAAO,EACd,cAAc,MAAM,EACpB,eAAe,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KACrC,OAAO,CAAC,KAAK,CAgDf,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,GACnC,OAAO,OAAO,EACd,WACI,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,aAAa,GACb,eAAe,EACnB,cAAc,MAAM,EACpB,aAAa,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,WAAW,MAAM,EACjB,qBAAqB,kBAAkB,KACtC,OAAO,CAAC,KAAK,CAuCf,CAAC"}

package/dist/handlers/tool-configs/universal/core/crud-error-handlers.js

@@ -19,6 +19,40 @@ const createErrorResult = (message, name, details) => {
 import { getSingularResourceType } from '../shared-handlers.js';
 import { sanitizedLog } from './pii-sanitizer.js';
 const logger = createScopedLogger('crud-error-handlers');
+/**
+ * Extract Attio API validation errors from error response
+ * HOTFIX: Improve error messaging for relationship field failures
+ */
+const extractAttioValidationErrors = (error) => {
+    try {
+        // Check for axios-style error response
+        if (error &&
+            typeof error === 'object' &&
+            'response' in error &&
+            error.response &&
+            typeof error.response === 'object' &&
+            'data' in error.response) {
+            const data = error.response.data;
+            if (data && typeof data === 'object' && 'validation_errors' in data) {
+                const validationErrors = data
+                    .validation_errors;
+                if (Array.isArray(validationErrors) && validationErrors.length > 0) {
+                    return validationErrors
+                        .map((err) => err.message || String(err))
+                        .join('; ');
+                }
+            }
+            // Also check for main error message
+            if (data && typeof data === 'object' && 'message' in data) {
+                return String(data.message);
+            }
+        }
+    }
+    catch {
+        // If extraction fails, return null and fall back to generic error handling
+    }
+    return null;
+};
 /**
  * Handles errors specific to record creation operations
  */
@@ -47,7 +81,11 @@ export const handleCreateError = async (error, resourceType, recordData) => {
         throw errorResult;
     }
     // Fallback to general create error handling
-    const errorMessage = error instanceof Error ? error.message : String(error);
+    const baseError = error instanceof Error ? error.message : String(error);
+    const apiErrors = extractAttioValidationErrors(error);
+    const errorMessage = apiErrors
+        ? `${baseError}. Details: ${apiErrors}`
+        : baseError;
     const errorResult = createErrorResult(`Failed to create ${getSingularResourceType(resourceType)}: ${errorMessage}`, 'create_error', { context, original: error });
     throw errorResult;
 };

package/dist/handlers/tool-configs/universal/core/crud-error-handlers.js.map

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

package/dist/handlers/tool-configs/universal/core/crud-operations.d.ts

@@ -30,6 +30,16 @@ export declare const createRecordDefinition: {
         };
         required: ("resource_type" | "record_data")[];
         additionalProperties: boolean;
+        examples: {
+            resource_type: string;
+            record_data: {
+                name: string;
+                email_addresses: {
+                    email_address: string;
+                }[];
+            };
+            return_details: boolean;
+        }[];
     };
     annotations: {
         readOnlyHint: boolean;
@@ -64,6 +74,14 @@ export declare const updateRecordDefinition: {
         };
         required: ("record_id" | "resource_type" | "record_data")[];
         additionalProperties: boolean;
+        examples: {
+            resource_type: string;
+            record_id: string;
+            record_data: {
+                status: string;
+            };
+            return_details: boolean;
+        }[];
     };
     annotations: {
         readOnlyHint: boolean;
@@ -88,6 +106,10 @@ export declare const deleteRecordDefinition: {
         };
         required: ("record_id" | "resource_type")[];
         additionalProperties: boolean;
+        examples: {
+            resource_type: string;
+            record_id: string;
+        }[];
     };
     annotations: {
         readOnlyHint: boolean;

package/dist/handlers/tool-configs/universal/core/crud-operations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"crud-operations.d.ts","sourceRoot":"","sources":["../../../../../src/handlers/tool-configs/universal/core/crud-operations.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAwB9E,eAAO,MAAM,kBAAkB,EAAE,mBAAmB,CAClD,qBAAqB,EACrB,WAAW,CAgEZ,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,mBAAmB,CAClD,qBAAqB,EACrB,mBAAmB,CAiGpB,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,mBAAmB,CAClD,qBAAqB,EACrB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAkCxC,CAAC;AAEF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAQlC,CAAC;AAEF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAQlC,CAAC;AAEF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;CAQlC,CAAC"}
+{"version":3,"file":"crud-operations.d.ts","sourceRoot":"","sources":["../../../../../src/handlers/tool-configs/universal/core/crud-operations.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAwB9E,eAAO,MAAM,kBAAkB,EAAE,mBAAmB,CAClD,qBAAqB,EACrB,WAAW,CAgEZ,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,mBAAmB,CAClD,qBAAqB,EACrB,mBAAmB,CAiGpB,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,mBAAmB,CAClD,qBAAqB,EACrB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAkCxC,CAAC;AAEF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAQlC,CAAC;AAEF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAQlC,CAAC;AAEF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;CAQlC,CAAC"}

package/dist/handlers/tool-configs/universal/core/detailed-info-operations.d.ts

@@ -18,6 +18,10 @@ export declare const getDetailedInfoDefinition: {
         };
         required: ("record_id" | "resource_type")[];
         additionalProperties: boolean;
+        examples: {
+            resource_type: string;
+            record_id: string;
+        }[];
     };
     annotations: {
         readOnlyHint: boolean;

package/dist/handlers/tool-configs/universal/core/detailed-info-operations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"detailed-info-operations.d.ts","sourceRoot":"","sources":["../../../../../src/handlers/tool-configs/universal/core/detailed-info-operations.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,2BAA2B,EAC3B,qBAAqB,EACtB,MAAM,aAAa,CAAC;AAUrB,eAAO,MAAM,qBAAqB,EAAE,mBAAmB,CACrD,2BAA2B,EAC3B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA+DxB,CAAC;AAEF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;CASrC,CAAC"}
+{"version":3,"file":"detailed-info-operations.d.ts","sourceRoot":"","sources":["../../../../../src/handlers/tool-configs/universal/core/detailed-info-operations.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,2BAA2B,EAC3B,qBAAqB,EACtB,MAAM,aAAa,CAAC;AAWrB,eAAO,MAAM,qBAAqB,EAAE,mBAAmB,CACrD,2BAA2B,EAC3B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA+DxB,CAAC;AAEF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgBrC,CAAC"}

package/dist/handlers/tool-configs/universal/core/detailed-info-operations.js

@@ -1,9 +1,10 @@
 import { getDetailedInfoSchema, validateUniversalToolParams, } from '../schemas.js';
 import { handleUniversalGetDetailedInfo, getSingularResourceType, } from '../shared-handlers.js';
+import { formatToolDescription } from '../../../../handlers/tools/standards/index.js';
 export const getDetailedInfoConfig = {
-    name: 'get-detailed-info',
+    name: 'records_get_info',
     handler: async (params) => {
-        validateUniversalToolParams('get-detailed-info', params);
+        validateUniversalToolParams('records_get_info', params);
         return await handleUniversalGetDetailedInfo(params);
     },
     formatResult: (info, ...args) => {
@@ -58,8 +59,13 @@ export const getDetailedInfoConfig = {
     },
 };
 export const getDetailedInfoDefinition = {
-    name: 'get-detailed-info',
-    description: 'Get specific types of detailed information (contact, business, social)',
+    name: 'records_get_info',
+    description: formatToolDescription({
+        capability: 'Retrieve enriched info subsets (contact, business, social) for a record.',
+        boundaries: 'search lists of records or mutate data.',
+        constraints: 'Requires resource_type, record_id, and info_type (contact|business|social).',
+        recoveryHint: 'Use records.get_details if you need the full record payload.',
+    }),
     inputSchema: getDetailedInfoSchema,
     annotations: {
         readOnlyHint: true,

package/dist/handlers/tool-configs/universal/core/detailed-info-operations.js.map

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

package/dist/handlers/tool-configs/universal/core/index.d.ts

@@ -7,29 +7,29 @@ import { createNoteConfig, listNotesConfig } from './notes-operations.js';
 export declare const coreOperationsToolConfigs: {
     'create-note': import("../types.js").UniversalToolConfig<Record<string, unknown>, Record<string, unknown>>;
     'list-notes': import("../types.js").UniversalToolConfig<Record<string, unknown>, Record<string, unknown>[]>;
-    'search-records': import("../types.js").UniversalToolConfig<import("../types.js").UniversalSearchParams, import("../../../../types/attio.js").AttioRecord[]>;
-    'get-record-details': import("../types.js").UniversalToolConfig<import("../types.js").UniversalRecordDetailsParams, import("../../../../types/attio.js").AttioRecord>;
+    records_search: import("../types.js").UniversalToolConfig<import("../types.js").UniversalSearchParams, import("../../../../types/attio.js").AttioRecord[]>;
+    records_get_details: import("../types.js").UniversalToolConfig<import("../types.js").UniversalRecordDetailsParams, import("../../../../types/attio.js").AttioRecord>;
     'create-record': import("../types.js").UniversalToolConfig<import("../types.js").UniversalCreateParams, import("../../../../types/attio.js").AttioRecord>;
     'update-record': import("../types.js").UniversalToolConfig<import("../types.js").UniversalUpdateParams, import("../../../../types/attio.js").EnhancedAttioRecord>;
     'delete-record': import("../types.js").UniversalToolConfig<import("../types.js").UniversalDeleteParams, {
         success: boolean;
         record_id: string;
     }>;
-    'get-attributes': import("../types.js").UniversalToolConfig<import("../types.js").UniversalAttributesParams, Record<string, unknown> | {
+    records_get_attributes: import("../types.js").UniversalToolConfig<import("../types.js").UniversalAttributesParams, Record<string, unknown> | {
         error: string;
         success: boolean;
     }>;
-    'discover-attributes': import("../types.js").UniversalToolConfig<{
+    records_discover_attributes: import("../types.js").UniversalToolConfig<{
         resource_type: import("../types.js").UniversalResourceType;
         categories?: string[];
     }, Record<string, unknown> | {
         error: string;
         success: boolean;
     }>;
-    'get-detailed-info': import("../types.js").UniversalToolConfig<import("../types.js").UniversalDetailedInfoParams, Record<string, unknown>>;
+    records_get_info: import("../types.js").UniversalToolConfig<import("../types.js").UniversalDetailedInfoParams, Record<string, unknown>>;
 };
 export declare const coreOperationsToolDefinitions: {
-    'search-records': {
+    records_search: {
         name: string;
         description: string;
         inputSchema: {
@@ -128,13 +128,18 @@ export declare const coreOperationsToolDefinitions: {
             };
             required: "resource_type"[];
             additionalProperties: boolean;
+            examples: {
+                resource_type: string;
+                query: string;
+                limit: number;
+            }[];
         };
         annotations: {
             readOnlyHint: boolean;
             idempotentHint: boolean;
         };
     };
-    'get-record-details': {
+    records_get_details: {
         name: string;
         description: string;
         inputSchema: {
@@ -159,6 +164,11 @@ export declare const coreOperationsToolDefinitions: {
             };
             required: ("record_id" | "resource_type")[];
             additionalProperties: boolean;
+            examples: {
+                resource_type: string;
+                record_id: string;
+                fields: string[];
+            }[];
         };
         annotations: {
             readOnlyHint: boolean;
@@ -189,6 +199,16 @@ export declare const coreOperationsToolDefinitions: {
             };
             required: ("resource_type" | "record_data")[];
             additionalProperties: boolean;
+            examples: {
+                resource_type: string;
+                record_data: {
+                    name: string;
+                    email_addresses: {
+                        email_address: string;
+                    }[];
+                };
+                return_details: boolean;
+            }[];
         };
         annotations: {
             readOnlyHint: boolean;
@@ -223,6 +243,14 @@ export declare const coreOperationsToolDefinitions: {
             };
             required: ("record_id" | "resource_type" | "record_data")[];
             additionalProperties: boolean;
+            examples: {
+                resource_type: string;
+                record_id: string;
+                record_data: {
+                    status: string;
+                };
+                return_details: boolean;
+            }[];
         };
         annotations: {
             readOnlyHint: boolean;
@@ -247,13 +275,17 @@ export declare const coreOperationsToolDefinitions: {
             };
             required: ("record_id" | "resource_type")[];
             additionalProperties: boolean;
+            examples: {
+                resource_type: string;
+                record_id: string;
+            }[];
         };
         annotations: {
             readOnlyHint: boolean;
             destructiveHint: boolean;
         };
     };
-    'get-attributes': {
+    records_get_attributes: {
         name: string;
         description: string;
         inputSchema: {
@@ -285,13 +317,17 @@ export declare const coreOperationsToolDefinitions: {
             };
             required: "resource_type"[];
             additionalProperties: boolean;
+            examples: {
+                resource_type: string;
+                categories: string[];
+            }[];
         };
         annotations: {
             readOnlyHint: boolean;
             idempotentHint: boolean;
         };
     };
-    'discover-attributes': {
+    records_discover_attributes: {
         name: string;
         description: string;
         inputSchema: {
@@ -312,13 +348,17 @@ export declare const coreOperationsToolDefinitions: {
             };
             required: "resource_type"[];
             additionalProperties: boolean;
+            examples: {
+                resource_type: string;
+                categories: string[];
+            }[];
         };
         annotations: {
             readOnlyHint: boolean;
             idempotentHint: boolean;
         };
     };
-    'get-detailed-info': {
+    records_get_info: {
         name: string;
         description: string;
         inputSchema: {
@@ -336,6 +376,10 @@ export declare const coreOperationsToolDefinitions: {
             };
             required: ("record_id" | "resource_type")[];
             additionalProperties: boolean;
+            examples: {
+                resource_type: string;
+                record_id: string;
+            }[];
         };
         annotations: {
             readOnlyHint: boolean;
@@ -365,8 +409,14 @@ export declare const coreOperationsToolDefinitions: {
                     type: "string";
                     description: string;
                 };
+                format: {
+                    type: "string";
+                    enum: string[];
+                    description: string;
+                    default: string;
+                };
             };
-            required: ("record_id" | "title" | "content" | "resource_type")[];
+            required: ("title" | "content" | "record_id" | "resource_type")[];
             additionalProperties: boolean;
         };
         annotations: {

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/handlers/tool-configs/universal/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EAEpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,sBAAsB,EAEvB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAInB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EAGzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,qBAAqB,EAEtB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,gBAAgB,EAChB,eAAe,EAGhB,MAAM,uBAAuB,CAAC;AAE/B,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;CAWrC,CAAC;AAEF,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAWzC,CAAC;AAEF,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,GAChB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/handlers/tool-configs/universal/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EAEpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,sBAAsB,EAEvB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAInB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EAGzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,qBAAqB,EAEtB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,gBAAgB,EAChB,eAAe,EAGhB,MAAM,uBAAuB,CAAC;AAE/B,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;CAWrC,CAAC;AAEF,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAWzC,CAAC;AAEF,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,GAChB,CAAC"}

package/dist/handlers/tool-configs/universal/core/index.js

@@ -7,24 +7,24 @@ import { createNoteConfig, listNotesConfig, createNoteDefinition, listNotesDefin
 export const coreOperationsToolConfigs = {
     'create-note': createNoteConfig,
     'list-notes': listNotesConfig,
-    'search-records': searchRecordsConfig,
-    'get-record-details': getRecordDetailsConfig,
+    records_search: searchRecordsConfig,
+    records_get_details: getRecordDetailsConfig,
     'create-record': createRecordConfig,
     'update-record': updateRecordConfig,
     'delete-record': deleteRecordConfig,
-    'get-attributes': getAttributesConfig,
-    'discover-attributes': discoverAttributesConfig,
-    'get-detailed-info': getDetailedInfoConfig,
+    records_get_attributes: getAttributesConfig,
+    records_discover_attributes: discoverAttributesConfig,
+    records_get_info: getDetailedInfoConfig,
 };
 export const coreOperationsToolDefinitions = {
-    'search-records': searchRecordsDefinition,
-    'get-record-details': getRecordDetailsDefinition,
+    records_search: searchRecordsDefinition,
+    records_get_details: getRecordDetailsDefinition,
     'create-record': createRecordDefinition,
     'update-record': updateRecordDefinition,
     'delete-record': deleteRecordDefinition,
-    'get-attributes': getAttributesDefinition,
-    'discover-attributes': discoverAttributesDefinition,
-    'get-detailed-info': getDetailedInfoDefinition,
+    records_get_attributes: getAttributesDefinition,
+    records_discover_attributes: discoverAttributesDefinition,
+    records_get_info: getDetailedInfoDefinition,
     'create-note': createNoteDefinition,
     'list-notes': listNotesDefinition,
 };

package/dist/handlers/tool-configs/universal/core/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/handlers/tool-configs/universal/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,EACvB,4BAA4B,GAC7B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,aAAa,EAAE,gBAAgB;IAC/B,YAAY,EAAE,eAAe;IAC7B,gBAAgB,EAAE,mBAAmB;IACrC,oBAAoB,EAAE,sBAAsB;IAC5C,eAAe,EAAE,kBAAkB;IACnC,eAAe,EAAE,kBAAkB;IACnC,eAAe,EAAE,kBAAkB;IACnC,gBAAgB,EAAE,mBAAmB;IACrC,qBAAqB,EAAE,wBAAwB;IAC/C,mBAAmB,EAAE,qBAAqB;CAC3C,CAAC;AAEF,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,gBAAgB,EAAE,uBAAuB;IACzC,oBAAoB,EAAE,0BAA0B;IAChD,eAAe,EAAE,sBAAsB;IACvC,eAAe,EAAE,sBAAsB;IACvC,eAAe,EAAE,sBAAsB;IACvC,gBAAgB,EAAE,uBAAuB;IACzC,qBAAqB,EAAE,4BAA4B;IACnD,mBAAmB,EAAE,yBAAyB;IAC9C,aAAa,EAAE,oBAAoB;IACnC,YAAY,EAAE,mBAAmB;CAClC,CAAC;AAEF,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,GAChB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/handlers/tool-configs/universal/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,EACvB,4BAA4B,GAC7B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,aAAa,EAAE,gBAAgB;IAC/B,YAAY,EAAE,eAAe;IAC7B,cAAc,EAAE,mBAAmB;IACnC,mBAAmB,EAAE,sBAAsB;IAC3C,eAAe,EAAE,kBAAkB;IACnC,eAAe,EAAE,kBAAkB;IACnC,eAAe,EAAE,kBAAkB;IACnC,sBAAsB,EAAE,mBAAmB;IAC3C,2BAA2B,EAAE,wBAAwB;IACrD,gBAAgB,EAAE,qBAAqB;CACxC,CAAC;AAEF,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,cAAc,EAAE,uBAAuB;IACvC,mBAAmB,EAAE,0BAA0B;IAC/C,eAAe,EAAE,sBAAsB;IACvC,eAAe,EAAE,sBAAsB;IACvC,eAAe,EAAE,sBAAsB;IACvC,sBAAsB,EAAE,uBAAuB;IAC/C,2BAA2B,EAAE,4BAA4B;IACzD,gBAAgB,EAAE,yBAAyB;IAC3C,aAAa,EAAE,oBAAoB;IACnC,YAAY,EAAE,mBAAmB;CAClC,CAAC;AAEF,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,GAChB,CAAC"}

package/dist/handlers/tool-configs/universal/core/metadata-operations.d.ts

@@ -42,6 +42,10 @@ export declare const getAttributesDefinition: {
         };
         required: "resource_type"[];
         additionalProperties: boolean;
+        examples: {
+            resource_type: string;
+            categories: string[];
+        }[];
     };
     annotations: {
         readOnlyHint: boolean;
@@ -69,6 +73,10 @@ export declare const discoverAttributesDefinition: {
         };
         required: "resource_type"[];
         additionalProperties: boolean;
+        examples: {
+            resource_type: string;
+            categories: string[];
+        }[];
     };
     annotations: {
         readOnlyHint: boolean;

package/dist/handlers/tool-configs/universal/core/metadata-operations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metadata-operations.d.ts","sourceRoot":"","sources":["../../../../../src/handlers/tool-configs/universal/core/metadata-operations.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,qBAAqB,EACtB,MAAM,aAAa,CAAC;AAYrB,eAAO,MAAM,mBAAmB,EAAE,mBAAmB,CACnD,yBAAyB,EACzB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAwF9D,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,mBAAmB,CACxD;IAAE,aAAa,EAAE,qBAAqB,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,EAC/D,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CA8H9D,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CASnC,CAAC;AAEF,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;CAQxC,CAAC"}
+{"version":3,"file":"metadata-operations.d.ts","sourceRoot":"","sources":["../../../../../src/handlers/tool-configs/universal/core/metadata-operations.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,qBAAqB,EACtB,MAAM,aAAa,CAAC;AAarB,eAAO,MAAM,mBAAmB,EAAE,mBAAmB,CACnD,yBAAyB,EACzB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAwF9D,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,mBAAmB,CACxD;IAAE,aAAa,EAAE,qBAAqB,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,EAC/D,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CA8H9D,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAcnC,CAAC;AAEF,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAexC,CAAC"}

package/dist/handlers/tool-configs/universal/core/metadata-operations.js

@@ -1,10 +1,11 @@
 import { getAttributesSchema, discoverAttributesSchema, validateUniversalToolParams, } from '../schemas.js';
 import { handleUniversalGetAttributes, handleUniversalDiscoverAttributes, getSingularResourceType, } from '../shared-handlers.js';
+import { formatToolDescription } from '../../../../handlers/tools/standards/index.js';
 export const getAttributesConfig = {
-    name: 'get-attributes',
+    name: 'records_get_attributes',
     handler: async (params) => {
         try {
-            const sanitizedParams = validateUniversalToolParams('get-attributes', params);
+            const sanitizedParams = validateUniversalToolParams('records_get_attributes', params);
             return await handleUniversalGetAttributes(sanitizedParams);
         }
         catch (error) {
@@ -69,10 +70,10 @@ export const getAttributesConfig = {
     },
 };
 export const discoverAttributesConfig = {
-    name: 'discover-attributes',
+    name: 'records_discover_attributes',
     handler: async (params) => {
         try {
-            const sanitizedParams = validateUniversalToolParams('discover-attributes', params);
+            const sanitizedParams = validateUniversalToolParams('records_discover_attributes', params);
             return await handleUniversalDiscoverAttributes(sanitizedParams.resource_type, {
                 categories: sanitizedParams.categories,
             });
@@ -168,8 +169,13 @@ export const discoverAttributesConfig = {
     },
 };
 export const getAttributesDefinition = {
-    name: 'get-attributes',
-    description: 'Get attributes for any resource type (companies, people, lists, records, tasks, deals, notes)',
+    name: 'records_get_attributes',
+    description: formatToolDescription({
+        capability: 'Retrieve attribute metadata for a given resource type.',
+        boundaries: 'modify schema definitions or record data.',
+        constraints: 'Requires resource_type; optional categories narrows groups.',
+        recoveryHint: 'Use records.discover_attributes for grouped schema discovery.',
+    }),
     inputSchema: getAttributesSchema,
     annotations: {
         readOnlyHint: true,
@@ -177,8 +183,13 @@ export const getAttributesDefinition = {
     },
 };
 export const discoverAttributesDefinition = {
-    name: 'discover-attributes',
-    description: 'Discover available attributes for any resource type',
+    name: 'records_discover_attributes',
+    description: formatToolDescription({
+        capability: 'Discover available attributes (standard/custom) for a resource.',
+        boundaries: 'alter schema or create fields.',
+        constraints: 'Requires resource_type; optional categories selects subsets.',
+        recoveryHint: 'Follow with records.get_attributes to inspect specific fields.',
+    }),
     inputSchema: discoverAttributesSchema,
     annotations: {
         readOnlyHint: true,