attio-mcp 1.3.5 → 1.4.0

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

@@ -8,14 +8,14 @@ import { searchByContentConfig } from './content-search.js';
 import { searchByTimeframeConfig } from './timeframe-search.js';
 import { batchOperationsConfig } from './batch-operations.js';
 export declare const advancedOperationsToolConfigs: {
-    records_search_advanced: import("../types.js").UniversalToolConfig<import("../types.js").AdvancedSearchParams, import("../../../../types/attio.js").AttioRecord[]>;
-    records_search_by_relationship: import("../types.js").UniversalToolConfig<import("../types.js").RelationshipSearchParams, import("../../../../types/attio.js").AttioRecord[]>;
-    records_search_by_content: import("../types.js").UniversalToolConfig<import("../types.js").ContentSearchParams, import("../../../../types/attio.js").AttioRecord[]>;
-    records_search_by_timeframe: import("../types.js").UniversalToolConfig<import("../types.js").TimeframeSearchParams, import("../../../../types/attio.js").AttioRecord[]>;
-    records_batch: import("../types.js").UniversalToolConfig<Record<string, unknown>, Record<string, unknown> | Record<string, unknown>[]>;
+    search_records_advanced: import("../types.js").UniversalToolConfig<import("../types.js").AdvancedSearchParams, import("../../../../types/attio.js").AttioRecord[]>;
+    search_records_by_relationship: import("../types.js").UniversalToolConfig<import("../types.js").RelationshipSearchParams, import("../../../../types/attio.js").AttioRecord[]>;
+    search_records_by_content: import("../types.js").UniversalToolConfig<import("../types.js").ContentSearchParams, import("../../../../types/attio.js").AttioRecord[]>;
+    search_records_by_timeframe: import("../types.js").UniversalToolConfig<import("../types.js").TimeframeSearchParams, import("../../../../types/attio.js").AttioRecord[]>;
+    batch_records: import("../types.js").UniversalToolConfig<Record<string, unknown>, Record<string, unknown> | Record<string, unknown>[]>;
 };
 export declare const advancedOperationsToolDefinitions: {
-    records_search_advanced: {
+    search_records_advanced: {
         name: string;
         description: string;
         inputSchema: {
@@ -79,7 +79,7 @@ export declare const advancedOperationsToolDefinitions: {
             idempotentHint: boolean;
         };
     };
-    records_search_by_relationship: {
+    search_records_by_relationship: {
         name: string;
         description: string;
         inputSchema: {
@@ -131,7 +131,7 @@ export declare const advancedOperationsToolDefinitions: {
             idempotentHint: boolean;
         };
     };
-    records_search_by_content: {
+    search_records_by_content: {
         name: string;
         description: string;
         inputSchema: {
@@ -178,7 +178,7 @@ export declare const advancedOperationsToolDefinitions: {
             idempotentHint: boolean;
         };
     };
-    records_search_by_timeframe: {
+    search_records_by_timeframe: {
         name: string;
         description: string;
         inputSchema: {
@@ -231,7 +231,7 @@ export declare const advancedOperationsToolDefinitions: {
             idempotentHint: boolean;
         };
     };
-    records_batch: {
+    batch_records: {
         name: string;
         description: string;
         inputSchema: {

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

@@ -10,15 +10,15 @@ import { batchOperationsConfig } from './batch-operations.js';
 import { formatToolDescription } from '../../../../handlers/tools/standards/index.js';
 import { advancedSearchSchema, searchByRelationshipSchema, searchByContentSchema, searchByTimeframeSchema, batchOperationsSchema, } from '../schemas.js';
 export const advancedOperationsToolConfigs = {
-    records_search_advanced: advancedSearchConfig,
-    records_search_by_relationship: searchByRelationshipConfig,
-    records_search_by_content: searchByContentConfig,
-    records_search_by_timeframe: searchByTimeframeConfig,
-    records_batch: batchOperationsConfig,
+    search_records_advanced: advancedSearchConfig,
+    search_records_by_relationship: searchByRelationshipConfig,
+    search_records_by_content: searchByContentConfig,
+    search_records_by_timeframe: searchByTimeframeConfig,
+    batch_records: batchOperationsConfig,
 };
 export const advancedOperationsToolDefinitions = {
-    records_search_advanced: {
-        name: 'records_search_advanced',
+    search_records_advanced: {
+        name: 'search_records_advanced',
         description: formatToolDescription({
             capability: 'Search companies, people, deals, or tasks with complex nested filters (e.g., find deals by owner+stage, companies by industry+location).',
             boundaries: 'mutate records; use records.update or records.delete.',
@@ -31,8 +31,8 @@ export const advancedOperationsToolDefinitions = {
             idempotentHint: true,
         },
     },
-    records_search_by_relationship: {
-        name: 'records_search_by_relationship',
+    search_records_by_relationship: {
+        name: 'search_records_by_relationship',
         description: formatToolDescription({
             capability: 'Search records using relationship anchors (list, company, people).',
             boundaries: 'modify memberships; use list tools for writes.',
@@ -45,8 +45,8 @@ export const advancedOperationsToolDefinitions = {
             idempotentHint: true,
         },
     },
-    records_search_by_content: {
-        name: 'records_search_by_content',
+    search_records_by_content: {
+        name: 'search_records_by_content',
         description: formatToolDescription({
             capability: 'Search record content (notes, activity, communications).',
             boundaries: 'modify note content or attachments.',
@@ -59,8 +59,8 @@ export const advancedOperationsToolDefinitions = {
             idempotentHint: true,
         },
     },
-    records_search_by_timeframe: {
-        name: 'records_search_by_timeframe',
+    search_records_by_timeframe: {
+        name: 'search_records_by_timeframe',
         description: formatToolDescription({
             capability: 'Filter records by creation, update, or interaction timeframes.',
             boundaries: 'modify lifecycle state or scheduling follow-ups.',
@@ -73,8 +73,8 @@ export const advancedOperationsToolDefinitions = {
             idempotentHint: true,
         },
     },
-    records_batch: {
-        name: 'records_batch',
+    batch_records: {
+        name: 'batch_records',
         description: formatToolDescription({
             capability: 'Execute batched record operations (create/update/delete/get/search).',
             boundaries: 'ignore approval guardrails; hosts may require confirmation.',

package/dist/handlers/tool-configs/universal/operations/relationship-search.js

@@ -10,10 +10,10 @@ import { searchCompaniesByPeople } from '../../../../objects/companies/index.js'
 import { searchPeopleByCompany } from '../../../../objects/people/index.js';
 import { searchDealsByCompany, searchDealsByPerson, } from '../../../../objects/deals/index.js';
 export const searchByRelationshipConfig = {
-    name: 'records_search_by_relationship',
+    name: 'search_records_by_relationship',
     handler: async (params) => {
         try {
-            const sanitizedParams = validateUniversalToolParams('records_search_by_relationship', params);
+            const sanitizedParams = validateUniversalToolParams('search_records_by_relationship', params);
             // Check for listId parameter first - if present and invalid, return error immediately
             if (params.listId && !isValidUUID(params.listId)) {
                 throw new Error(`Invalid list_id: must be a UUID. Got: ${params.listId}`);
@@ -53,7 +53,7 @@ export const searchByRelationshipConfig = {
             }
         }
         catch (error) {
-            throw ErrorService.createUniversalError('records_search_by_relationship', params.relationship_type, error);
+            throw ErrorService.createUniversalError('search_records_by_relationship', params.relationship_type, error);
         }
     },
     formatResult: (results, ...args) => {

package/dist/handlers/tool-configs/universal/operations/timeframe-search.js

@@ -10,10 +10,10 @@ import { getPluralResourceType } from '../../../tool-configs/universal/core/util
 import { normalizeOperator } from '../../../../utils/AttioFilterOperators.js';
 import { mapFieldName } from '../../../../utils/AttioFieldMapper.js';
 export const searchByTimeframeConfig = {
-    name: 'records_search_by_timeframe',
+    name: 'search_records_by_timeframe',
     handler: async (params) => {
         try {
-            const sanitizedParams = validateUniversalToolParams('records_search_by_timeframe', params);
+            const sanitizedParams = validateUniversalToolParams('search_records_by_timeframe', params);
             const { resource_type, timeframe_type, start_date, end_date, relative_range, invert_range, date_field, limit, offset, } = sanitizedParams;
             // Process relative_range parameter if provided (Issue #475)
             let processedStartDate = start_date;
@@ -149,7 +149,7 @@ export const searchByTimeframeConfig = {
             });
         }
         catch (error) {
-            throw ErrorService.createUniversalError('records_search_by_timeframe', `${params.resource_type}:${params.timeframe_type || 'undefined'}`, error);
+            throw ErrorService.createUniversalError('search_records_by_timeframe', `${params.resource_type}:${params.timeframe_type || 'undefined'}`, error);
         }
     },
     formatResult: (results, ...args) => {

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

@@ -1 +1 @@
-{"version":3,"file":"utility-schemas.d.ts","sourceRoot":"","sources":["../../../../../src/handlers/tool-configs/universal/schemas/utility-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AAMnF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6B5B,CAAC;AAEF,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;CAkB1B,CAAC;AAEF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;CAQ5B,CAAC;AAEF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;CAgB7B,CAAC;AAEF,eAAO,MAAM,gBAAgB;;;;;;;;;;CAO5B,CAAC;AAEF,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgB3B,CAAC"}
+{"version":3,"file":"utility-schemas.d.ts","sourceRoot":"","sources":["../../../../../src/handlers/tool-configs/universal/schemas/utility-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AAMnF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkC5B,CAAC;AAEF,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;CAkB1B,CAAC;AAEF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;CAQ5B,CAAC;AAEF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;CAgB7B,CAAC;AAEF,eAAO,MAAM,gBAAgB;;;;;;;;;;CAO5B,CAAC;AAEF,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgB3B,CAAC"}

package/dist/handlers/tool-configs/universal/schemas/utility-schemas.js

@@ -13,11 +13,14 @@ export const createNoteSchema = {
             description: 'ID of the record to attach the note to',
         },
         title: { type: 'string', description: 'Title of the note' },
-        content: { type: 'string', description: 'Content of the note' },
+        content: {
+            type: 'string',
+            description: 'Note content. Use \\n for line breaks. With format="markdown": supports # headings, - bullets, 1. numbered lists, **bold**, `code`, nested lists (2-space indent).',
+        },
         format: {
             type: 'string',
             enum: ['plaintext', 'markdown'],
-            description: 'Content format (default: plaintext)',
+            description: 'Content format. Use "markdown" for rich text: headings, lists, bold, code blocks. Default: plaintext.',
             // Note: Default value 'plaintext' is enforced in src/api/operations/notes.ts:57
             default: 'plaintext',
         },

package/dist/handlers/tool-configs/universal/schemas/utility-schemas.js.map

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

package/dist/handlers/tool-configs/universal/schemas/validation-schemas.d.ts

@@ -53,4 +53,33 @@ export declare const discoverAttributesSchema: {
         categories: string[];
     }[];
 };
+export declare const getAttributeOptionsSchema: {
+    type: "object";
+    properties: {
+        resource_type: {
+            type: "string";
+            description: string;
+        };
+        attribute: {
+            type: "string";
+            description: string;
+        };
+        show_archived: {
+            type: "boolean";
+            default: boolean;
+            description: string;
+        };
+    };
+    required: ("attribute" | "resource_type")[];
+    additionalProperties: boolean;
+    examples: ({
+        resource_type: string;
+        attribute: string;
+        show_archived?: undefined;
+    } | {
+        resource_type: string;
+        attribute: string;
+        show_archived: boolean;
+    })[];
+};
 //# sourceMappingURL=validation-schemas.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"validation-schemas.d.ts","sourceRoot":"","sources":["../../../../../src/handlers/tool-configs/universal/schemas/validation-schemas.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2B/B,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;CAkBpC,CAAC"}
+{"version":3,"file":"validation-schemas.d.ts","sourceRoot":"","sources":["../../../../../src/handlers/tool-configs/universal/schemas/validation-schemas.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2B/B,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;CAkBpC,CAAC;AAEF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BrC,CAAC"}

package/dist/handlers/tool-configs/universal/schemas/validation-schemas.js

@@ -46,4 +46,32 @@ export const discoverAttributesSchema = {
         },
     ],
 };
+export const getAttributeOptionsSchema = {
+    type: 'object',
+    properties: {
+        resource_type: resourceTypeProperty,
+        attribute: {
+            type: 'string',
+            description: 'The attribute slug or ID (e.g., "channel", "stage", "categories")',
+        },
+        show_archived: {
+            type: 'boolean',
+            default: false,
+            description: 'Include archived options in the response',
+        },
+    },
+    required: ['resource_type', 'attribute'],
+    additionalProperties: false,
+    examples: [
+        {
+            resource_type: 'companies',
+            attribute: 'channel',
+        },
+        {
+            resource_type: 'deals',
+            attribute: 'stage',
+            show_archived: true,
+        },
+    ],
+};
 //# sourceMappingURL=validation-schemas.js.map

package/dist/handlers/tool-configs/universal/schemas/validation-schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"validation-schemas.js","sourceRoot":"","sources":["../../../../../src/handlers/tool-configs/universal/schemas/validation-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,QAAiB;IACvB,UAAU,EAAE;QACV,aAAa,EAAE,oBAAoB;QACnC,SAAS,EAAE;YACT,IAAI,EAAE,QAAiB;YACvB,WAAW,EAAE,4CAA4C;SAC1D;QACD,UAAU,EAAE;YACV,IAAI,EAAE,OAAgB;YACtB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;YAClC,WAAW,EAAE,sBAAsB;SACpC;QACD,MAAM,EAAE;YACN,IAAI,EAAE,OAAgB;YACtB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;YAClC,WAAW,EAAE,gCAAgC;SAC9C;KACF;IACD,QAAQ,EAAE,CAAC,eAAwB,CAAC;IACpC,oBAAoB,EAAE,KAAK;IAC3B,QAAQ,EAAE;QACR;YACE,aAAa,EAAE,WAAW;YAC1B,UAAU,EAAE,CAAC,UAAU,CAAC;SACzB;KACF;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,IAAI,EAAE,QAAiB;IACvB,UAAU,EAAE;QACV,aAAa,EAAE,oBAAoB;QACnC,UAAU,EAAE;YACV,IAAI,EAAE,OAAgB;YACtB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;YAClC,WAAW,EAAE,sBAAsB;SACpC;KACF;IACD,QAAQ,EAAE,CAAC,eAAwB,CAAC;IACpC,oBAAoB,EAAE,KAAK;IAC3B,QAAQ,EAAE;QACR;YACE,aAAa,EAAE,QAAQ;YACvB,UAAU,EAAE,CAAC,QAAQ,CAAC;SACvB;KACF;CACF,CAAC"}
+{"version":3,"file":"validation-schemas.js","sourceRoot":"","sources":["../../../../../src/handlers/tool-configs/universal/schemas/validation-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,QAAiB;IACvB,UAAU,EAAE;QACV,aAAa,EAAE,oBAAoB;QACnC,SAAS,EAAE;YACT,IAAI,EAAE,QAAiB;YACvB,WAAW,EAAE,4CAA4C;SAC1D;QACD,UAAU,EAAE;YACV,IAAI,EAAE,OAAgB;YACtB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;YAClC,WAAW,EAAE,sBAAsB;SACpC;QACD,MAAM,EAAE;YACN,IAAI,EAAE,OAAgB;YACtB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;YAClC,WAAW,EAAE,gCAAgC;SAC9C;KACF;IACD,QAAQ,EAAE,CAAC,eAAwB,CAAC;IACpC,oBAAoB,EAAE,KAAK;IAC3B,QAAQ,EAAE;QACR;YACE,aAAa,EAAE,WAAW;YAC1B,UAAU,EAAE,CAAC,UAAU,CAAC;SACzB;KACF;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,IAAI,EAAE,QAAiB;IACvB,UAAU,EAAE;QACV,aAAa,EAAE,oBAAoB;QACnC,UAAU,EAAE;YACV,IAAI,EAAE,OAAgB;YACtB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;YAClC,WAAW,EAAE,sBAAsB;SACpC;KACF;IACD,QAAQ,EAAE,CAAC,eAAwB,CAAC;IACpC,oBAAoB,EAAE,KAAK;IAC3B,QAAQ,EAAE;QACR;YACE,aAAa,EAAE,QAAQ;YACvB,UAAU,EAAE,CAAC,QAAQ,CAAC;SACvB;KACF;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,IAAI,EAAE,QAAiB;IACvB,UAAU,EAAE;QACV,aAAa,EAAE,oBAAoB;QACnC,SAAS,EAAE;YACT,IAAI,EAAE,QAAiB;YACvB,WAAW,EACT,mEAAmE;SACtE;QACD,aAAa,EAAE;YACb,IAAI,EAAE,SAAkB;YACxB,OAAO,EAAE,KAAK;YACd,WAAW,EAAE,0CAA0C;SACxD;KACF;IACD,QAAQ,EAAE,CAAC,eAAwB,EAAE,WAAoB,CAAC;IAC1D,oBAAoB,EAAE,KAAK;IAC3B,QAAQ,EAAE;QACR;YACE,aAAa,EAAE,WAAW;YAC1B,SAAS,EAAE,SAAS;SACrB;QACD;YACE,aAAa,EAAE,OAAO;YACtB,SAAS,EAAE,OAAO;YAClB,aAAa,EAAE,IAAI;SACpB;KACF;CACF,CAAC"}

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

@@ -3,7 +3,7 @@ export type { SanitizedValue, SanitizedObject, } from './schemas/common/types.js
 export { InputSanitizer, validateUniversalToolParams, } from './validators/schema-validator.js';
 export { CrossResourceValidator } from './validators/cross-resource-validator.js';
 export { searchRecordsSchema, getRecordDetailsSchema, createRecordSchema, updateRecordSchema, deleteRecordSchema, } from './schemas/core-schemas.js';
-export { getAttributesSchema, discoverAttributesSchema, } from './schemas/validation-schemas.js';
+export { getAttributesSchema, discoverAttributesSchema, getAttributeOptionsSchema, } from './schemas/validation-schemas.js';
 export { getDetailedInfoSchema, advancedSearchSchema, searchByRelationshipSchema, searchByContentSchema, searchByTimeframeSchema, batchOperationsSchema, } from './schemas/advanced-schemas.js';
 export { createNoteSchema, getNotesSchema, updateNoteSchema, searchNotesSchema, deleteNoteSchema, listNotesSchema, } from './schemas/utility-schemas.js';
 //# sourceMappingURL=schemas.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../../src/handlers/tool-configs/universal/schemas.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,SAAS,EACT,cAAc,EACd,wBAAwB,GACzB,MAAM,+BAA+B,CAAC;AACvC,YAAY,EACV,cAAc,EACd,eAAe,GAChB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,cAAc,EACd,2BAA2B,GAC5B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAGlF,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,iCAAiC,CAAC;AAGzC,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,0BAA0B,EAC1B,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,GAChB,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../../src/handlers/tool-configs/universal/schemas.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,SAAS,EACT,cAAc,EACd,wBAAwB,GACzB,MAAM,+BAA+B,CAAC;AACvC,YAAY,EACV,cAAc,EACd,eAAe,GAChB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,cAAc,EACd,2BAA2B,GAC5B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAGlF,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,iCAAiC,CAAC;AAGzC,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,0BAA0B,EAC1B,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,GAChB,MAAM,8BAA8B,CAAC"}

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

@@ -6,7 +6,7 @@ export { CrossResourceValidator } from './validators/cross-resource-validator.js
 // Core CRUD schemas
 export { searchRecordsSchema, getRecordDetailsSchema, createRecordSchema, updateRecordSchema, deleteRecordSchema, } from './schemas/core-schemas.js';
 // Validation-related schemas (attributes)
-export { getAttributesSchema, discoverAttributesSchema, } from './schemas/validation-schemas.js';
+export { getAttributesSchema, discoverAttributesSchema, getAttributeOptionsSchema, } from './schemas/validation-schemas.js';
 // Advanced and batch schemas
 export { getDetailedInfoSchema, advancedSearchSchema, searchByRelationshipSchema, searchByContentSchema, searchByTimeframeSchema, batchOperationsSchema, } from './schemas/advanced-schemas.js';
 // Notes and utility schemas

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

@@ -1 +1 @@
-{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../../src/handlers/tool-configs/universal/schemas.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,sDAAsD;AAEtD,OAAO,EACL,SAAS,EACT,cAAc,EACd,wBAAwB,GACzB,MAAM,+BAA+B,CAAC;AAKvC,OAAO,EACL,cAAc,EACd,2BAA2B,GAC5B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAElF,oBAAoB;AACpB,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AAEnC,0CAA0C;AAC1C,OAAO,EACL,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,iCAAiC,CAAC;AAEzC,6BAA6B;AAC7B,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,0BAA0B,EAC1B,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,+BAA+B,CAAC;AAEvC,4BAA4B;AAC5B,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,GAChB,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../../src/handlers/tool-configs/universal/schemas.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,sDAAsD;AAEtD,OAAO,EACL,SAAS,EACT,cAAc,EACd,wBAAwB,GACzB,MAAM,+BAA+B,CAAC;AAKvC,OAAO,EACL,cAAc,EACd,2BAA2B,GAC5B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAElF,oBAAoB;AACpB,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AAEnC,0CAA0C;AAC1C,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,iCAAiC,CAAC;AAEzC,6BAA6B;AAC7B,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,0BAA0B,EAC1B,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,+BAA+B,CAAC;AAEvC,4BAA4B;AAC5B,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,GAChB,MAAM,8BAA8B,CAAC"}

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

@@ -4,8 +4,9 @@
  * These utilities provide parameter-based routing to delegate universal
  * tool operations to existing resource-specific handlers.
  */
-import { UniversalResourceType, UniversalSearchParams, UniversalRecordDetailsParams, UniversalCreateParams, UniversalUpdateParams, UniversalDeleteParams, UniversalAttributesParams, UniversalDetailedInfoParams, UniversalCreateNoteParams, UniversalGetNotesParams, UniversalUpdateNoteParams, UniversalSearchNotesParams, UniversalDeleteNoteParams } from './types.js';
+import { UniversalResourceType, UniversalSearchParams, UniversalRecordDetailsParams, UniversalCreateParams, UniversalUpdateParams, UniversalDeleteParams, UniversalAttributesParams, UniversalDetailedInfoParams, UniversalCreateNoteParams, UniversalGetNotesParams, UniversalUpdateNoteParams, UniversalSearchNotesParams, UniversalDeleteNoteParams, UniversalGetAttributeOptionsParams } from './types.js';
 import { JsonObject } from '../../../types/attio.js';
+import { type AttributeOptionsResult } from '../../../services/metadata/index.js';
 import { AttioRecord } from '../../../types/attio.js';
 /**
  * Universal search handler - delegates to UniversalSearchService
@@ -70,6 +71,24 @@ export declare function handleUniversalGetAttributes(params: UniversalAttributes
 export declare function handleUniversalDiscoverAttributes(resource_type: UniversalResourceType, options?: {
     categories?: string[];
 }): Promise<JsonObject>;
+export declare const normalizeAttributeValue: (value: string) => string;
+/**
+ * Resolve display name to API slug for an attribute
+ * Fetches attribute metadata and finds the slug by title match
+ *
+ * @param objectSlug - The object slug (e.g., "deals", "companies")
+ * @param displayName - The display name to resolve (e.g., "Deal stage")
+ * @returns The API slug if found, or null
+ */
+export declare function resolveAttributeDisplayName(objectSlug: string, displayName: string): Promise<string | null>;
+export declare const getSimilarAttributeSlugs: (objectSlug: string, attribute: string, maxResults?: number) => Promise<string[]>;
+/**
+ * Universal get attribute options handler
+ * Retrieves valid options for select, multi-select, and status attributes
+ *
+ * Supports both API slugs (e.g., "stage") and display names (e.g., "Deal stage")
+ */
+export declare function handleUniversalGetAttributeOptions(params: UniversalGetAttributeOptionsParams): Promise<AttributeOptionsResult>;
 /**
  * Universal get detailed info handler
  */

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

@@ -1 +1 @@
-{"version":3,"file":"shared-handlers.d.ts","sourceRoot":"","sources":["../../../../src/handlers/tool-configs/universal/shared-handlers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,4BAA4B,EAC5B,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,yBAAyB,EACzB,2BAA2B,EAC3B,yBAAyB,EACzB,uBAAuB,EACvB,yBAAyB,EACzB,0BAA0B,EAC1B,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAkCrD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,WAAW,EAAE,CAAC,CAExB;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,4BAA4B,GACnC,OAAO,CAAC,WAAW,CAAC,CAEtB;AAED;;GAEG;AAEH;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,yBAAyB,GAChC,OAAO,CAAC,UAAU,CAAC,CA2CrB;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,UAAU,EAAE,CAAC,CAsDvB;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,UAAU,EAAE,CAAC,CAEvB;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,yBAAyB,GAChC,OAAO,CAAC,UAAU,CAAC,CAWrB;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,0BAA0B,GACjC,OAAO,CAAC,UAAU,EAAE,CAAC,CAgCvB;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,yBAAyB,GAChC,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAMhD;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,WAAW,CAAC,CAEtB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,WAAW,CAAC,CAEtB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAElD;AAED;;GAEG;AACH,wBAAsB,4BAA4B,CAChD,MAAM,EAAE,yBAAyB,GAChC,OAAO,CAAC,UAAU,CAAC,CAErB;AAED;;GAEG;AACH,wBAAsB,iCAAiC,CACrD,aAAa,EAAE,qBAAqB,EACpC,OAAO,CAAC,EAAE;IACR,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB,GACA,OAAO,CAAC,UAAU,CAAC,CAErB;AAED;;GAEG;AACH,wBAAsB,8BAA8B,CAClD,MAAM,EAAE,2BAA2B,GAClC,OAAO,CAAC,UAAU,CAAC,CA+CrB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,qBAAqB,GAClC,MAAM,CAER;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,qBAAqB,GAClC,MAAM,CAER;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,MAAM,GACnB,YAAY,IAAI,qBAAqB,CAEvC"}
+{"version":3,"file":"shared-handlers.d.ts","sourceRoot":"","sources":["../../../../src/handlers/tool-configs/universal/shared-handlers.ts"],"names":[],"mappings":"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"}

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

@@ -13,6 +13,7 @@ import { UniversalUpdateService } from '../../../services/UniversalUpdateService
 import { UniversalRetrievalService } from '../../../services/UniversalRetrievalService.js';
 import { UniversalSearchService } from '../../../services/UniversalSearchService.js';
 import { UniversalCreateService } from '../../../services/UniversalCreateService.js';
+import { AttributeOptionsService, } from '../../../services/metadata/index.js';
 import { getLazyAttioClient } from '../../../api/lazy-client.js';
 // Import existing handlers by resource type
 import { getListDetails } from '../../../objects/lists.js';
@@ -213,6 +214,221 @@ export async function handleUniversalGetAttributes(params) {
 export async function handleUniversalDiscoverAttributes(resource_type, options) {
     return UniversalMetadataService.discoverAttributes(resource_type, options);
 }
+/**
+ * Object slug mapping for resource types
+ */
+const OBJECT_SLUG_MAP = {
+    companies: 'companies',
+    people: 'people',
+    deals: 'deals',
+    tasks: 'tasks',
+    records: 'records',
+    lists: 'lists',
+    notes: 'notes',
+};
+export const normalizeAttributeValue = (value) => value.trim().toLowerCase();
+const levenshteinDistance = (a, b) => {
+    const matrix = [];
+    for (let i = 0; i <= a.length; i++) {
+        matrix[i] = [i];
+    }
+    for (let j = 0; j <= b.length; j++) {
+        matrix[0][j] = j;
+    }
+    for (let i = 1; i <= a.length; i++) {
+        for (let j = 1; j <= b.length; j++) {
+            if (a[i - 1] === b[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[a.length][b.length];
+};
+const getAttributeSchema = async (objectSlug) => {
+    const schema = await handleUniversalDiscoverAttributes(objectSlug);
+    return (schema.all || []);
+};
+/**
+ * Resolve display name to API slug for an attribute
+ * Fetches attribute metadata and finds the slug by title match
+ *
+ * @param objectSlug - The object slug (e.g., "deals", "companies")
+ * @param displayName - The display name to resolve (e.g., "Deal stage")
+ * @returns The API slug if found, or null
+ */
+export async function resolveAttributeDisplayName(objectSlug, displayName) {
+    try {
+        const allAttrs = await getAttributeSchema(objectSlug);
+        const normalizedInput = normalizeAttributeValue(displayName);
+        const exactMatch = allAttrs.find((attr) => {
+            const candidates = [attr.title, attr.name, attr.api_slug].filter(Boolean);
+            return candidates.some((candidate) => normalizeAttributeValue(candidate) === normalizedInput);
+        });
+        if (exactMatch?.api_slug) {
+            debug('shared-handlers', `Resolved display name "${displayName}" to API slug "${exactMatch.api_slug}"`, { attribute: displayName, resolvedSlug: exactMatch.api_slug }, 'resolveDisplayName', OperationType.DATA_PROCESSING);
+            return exactMatch.api_slug;
+        }
+        const partialMatch = allAttrs.find((attr) => {
+            const title = attr.title ? normalizeAttributeValue(attr.title) : null;
+            const slug = attr.api_slug
+                ? normalizeAttributeValue(attr.api_slug)
+                : null;
+            return ((title && title.includes(normalizedInput)) ||
+                (slug && slug.includes(normalizedInput)) ||
+                (title && normalizedInput.includes(title)) ||
+                (slug && normalizedInput.includes(slug)));
+        });
+        if (partialMatch?.api_slug) {
+            debug('shared-handlers', `Resolved display name "${displayName}" to API slug "${partialMatch.api_slug}" via partial match`, { attribute: displayName, resolvedSlug: partialMatch.api_slug }, 'resolveDisplayName', OperationType.DATA_PROCESSING);
+            return partialMatch.api_slug;
+        }
+        const typoCandidates = allAttrs
+            .filter((attr) => attr.api_slug)
+            .map((attr) => {
+            const slug = attr.api_slug;
+            const title = attr.title || attr.name || slug;
+            return {
+                slug,
+                distance: Math.min(levenshteinDistance(normalizedInput, normalizeAttributeValue(slug)), levenshteinDistance(normalizedInput, normalizeAttributeValue(title))),
+            };
+        })
+            .filter((candidate) => candidate.distance <= 2)
+            .sort((a, b) => a.distance - b.distance);
+        if (typoCandidates.length > 0) {
+            debug('shared-handlers', `Resolved display name "${displayName}" to API slug "${typoCandidates[0].slug}" via typo tolerance`, { attribute: displayName, resolvedSlug: typoCandidates[0].slug }, 'resolveDisplayName', OperationType.DATA_PROCESSING);
+            return typoCandidates[0].slug;
+        }
+        return null;
+    }
+    catch {
+        // If discovery fails, return null - the original error will be shown
+        return null;
+    }
+}
+export const getSimilarAttributeSlugs = async (objectSlug, attribute, maxResults = 3) => {
+    try {
+        const allAttrs = await getAttributeSchema(objectSlug);
+        const normalizedInput = normalizeAttributeValue(attribute);
+        const candidates = allAttrs
+            .filter((attr) => attr.api_slug)
+            .map((attr) => {
+            const slug = attr.api_slug;
+            const title = attr.title || attr.name || slug;
+            return {
+                slug,
+                distance: Math.min(levenshteinDistance(normalizedInput, normalizeAttributeValue(slug)), levenshteinDistance(normalizedInput, normalizeAttributeValue(title))),
+            };
+        })
+            .sort((a, b) => a.distance - b.distance);
+        const partials = allAttrs
+            .filter((attr) => attr.api_slug)
+            .filter((attr) => {
+            const title = attr.title ? normalizeAttributeValue(attr.title) : '';
+            const slug = attr.api_slug
+                ? normalizeAttributeValue(attr.api_slug)
+                : '';
+            return (title.includes(normalizedInput) ||
+                slug.includes(normalizedInput) ||
+                normalizedInput.includes(title) ||
+                normalizedInput.includes(slug));
+        })
+            .map((attr) => attr.api_slug);
+        const combined = [
+            ...partials,
+            ...candidates.map((candidate) => candidate.slug),
+        ];
+        const unique = [];
+        for (const slug of combined) {
+            if (!unique.includes(slug)) {
+                unique.push(slug);
+            }
+        }
+        return unique.slice(0, maxResults);
+    }
+    catch {
+        return [];
+    }
+};
+/**
+ * Universal get attribute options handler
+ * Retrieves valid options for select, multi-select, and status attributes
+ *
+ * Supports both API slugs (e.g., "stage") and display names (e.g., "Deal stage")
+ */
+export async function handleUniversalGetAttributeOptions(params) {
+    const { resource_type, attribute, show_archived } = params;
+    // Map resource type to object slug
+    const objectSlug = OBJECT_SLUG_MAP[resource_type.toLowerCase()] || resource_type.toLowerCase();
+    // Lists require both list_id and attribute_slug - not yet supported via this tool
+    // TODO: Add list_id parameter to support list attributes (see plan Phase 3B)
+    if (resource_type === UniversalResourceType.LISTS) {
+        throw new Error('records_get_attribute_options does not yet support list attributes. ' +
+            'Use get-list-details to inspect list attribute schemas instead.');
+    }
+    // First attempt: try with the attribute as provided (may be slug or display name)
+    try {
+        return await AttributeOptionsService.getOptions(objectSlug, attribute, show_archived);
+    }
+    catch (firstError) {
+        let latestError = firstError;
+        // Check if this looks like a display name (contains space or uppercase)
+        const mightBeDisplayName = attribute.includes(' ') || /[A-Z]/.test(attribute);
+        if (mightBeDisplayName) {
+            // Try to resolve display name to API slug
+            const resolvedSlug = await resolveAttributeDisplayName(objectSlug, attribute);
+            if (resolvedSlug && resolvedSlug !== attribute) {
+                try {
+                    // Retry with resolved slug
+                    debug('shared-handlers', `Resolved display name "${attribute}" to API slug "${resolvedSlug}"`, { attribute, resolvedSlug }, 'resolveDisplayName', OperationType.DATA_PROCESSING);
+                    return await AttributeOptionsService.getOptions(objectSlug, resolvedSlug, show_archived);
+                }
+                catch (retryError) {
+                    latestError = retryError;
+                }
+            }
+        }
+        const errorMsg = latestError instanceof Error ? latestError.message : String(latestError);
+        let slugExists = null;
+        try {
+            const allAttrs = await getAttributeSchema(objectSlug);
+            const normalizedAttr = normalizeAttributeValue(attribute);
+            const displayNameMatch = allAttrs.find((attr) => {
+                const title = attr.title ? normalizeAttributeValue(attr.title) : '';
+                const name = attr.name ? normalizeAttributeValue(attr.name) : '';
+                return title === normalizedAttr || name === normalizedAttr;
+            });
+            if (displayNameMatch?.api_slug &&
+                displayNameMatch.api_slug !== attribute) {
+                try {
+                    return await AttributeOptionsService.getOptions(objectSlug, displayNameMatch.api_slug, show_archived);
+                }
+                catch (retryError) {
+                    latestError = retryError;
+                }
+            }
+            slugExists = allAttrs.some((attr) => attr.api_slug &&
+                normalizeAttributeValue(attr.api_slug) === normalizedAttr);
+            if (slugExists === false) {
+                const suggestions = await getSimilarAttributeSlugs(objectSlug, attribute);
+                const suggestionText = suggestions.length > 0
+                    ? ` Did you mean: ${suggestions.map((s) => `"${s}"`).join(', ')}?`
+                    : '';
+                throw new Error(`Attribute "${attribute}" not found on ${objectSlug}.${suggestionText}\n\n` +
+                    `Use API slugs (e.g., "stage" not "Deal stage"). Run records_discover_attributes(resource_type="${objectSlug}") to see available attribute slugs.`);
+            }
+        }
+        catch (resolutionError) {
+            if (resolutionError instanceof Error) {
+                throw resolutionError;
+            }
+        }
+        throw new Error(`${errorMsg}\n\nTip: Use the API slug (e.g., "stage") not the display name (e.g., "Deal stage"). ` +
+            `Run records_discover_attributes to see available attribute slugs.`);
+    }
+}
 /**
  * Universal get detailed info handler
  */