feat(attio): add attribute tools + fix API alignment gaps

apps/sim/tools/attio/assert_record.ts

@@ -56,11 +56,11 @@ export const attioAssertRecordTool: ToolConfig<AttioAssertRecordParams, AttioAss
         'Content-Type': 'application/json',
       }),
       body: (params) => {
-        let values: Record<string, unknown> = {}
+        let values: Record<string, unknown>
         try {
           values = typeof params.values === 'string' ? JSON.parse(params.values) : params.values
         } catch {
-          values = {}
+          throw new Error('Invalid JSON provided for record values')
         }
         return { data: { values } }
       },

apps/sim/tools/attio/create_attribute.ts

@@ -0,0 +1,157 @@
+import { createLogger } from '@sim/logger'
+import type { ToolConfig } from '@/tools/types'
+import type { AttioCreateAttributeParams, AttioCreateAttributeResponse } from './types'
+import { ATTRIBUTE_OUTPUT_PROPERTIES } from './types'
+
+const logger = createLogger('AttioCreateAttribute')
+
+export const attioCreateAttributeTool: ToolConfig<
+  AttioCreateAttributeParams,
+  AttioCreateAttributeResponse
+> = {
+  id: 'attio_create_attribute',
+  name: 'Attio Create Attribute',
+  description: 'Create a new attribute (schema field) on an Attio object or list',
+  version: '1.0.0',
+
+  oauth: {
+    required: true,
+    provider: 'attio',
+  },
+
+  params: {
+    accessToken: {
+      type: 'string',
+      required: true,
+      visibility: 'hidden',
+      description: 'The OAuth access token for the Attio API',
+    },
+    target: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'Whether to create the attribute on an object or a list: objects or lists',
+    },
+    identifier: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'The object or list ID or slug (e.g. people, companies)',
+    },
+    title: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'The attribute display title',
+    },
+    apiSlug: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'The attribute API slug (unique, snake_case)',
+    },
+    type: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description:
+        'The attribute value type (e.g. text, number, checkbox, currency, date, timestamp, rating, status, select, record-reference, actor-reference, location, domain, email-address, phone-number)',
+    },
+    description: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'A description of the attribute',
+    },
+    isRequired: {
+      type: 'boolean',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Whether new records must provide a value (default false)',
+    },
+    isUnique: {
+      type: 'boolean',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Whether the attribute enforces uniqueness on new data (default false)',
+    },
+    isMultiselect: {
+      type: 'boolean',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Whether the attribute supports multiple values (default false)',
+    },
+    config: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description:
+        'JSON object of type-dependent configuration (e.g. currency or record-reference settings)',
+    },
+  },
+
+  request: {
+    url: (params) =>
+      `https://api.attio.com/v2/${params.target.trim()}/${params.identifier.trim()}/attributes`,
+    method: 'POST',
+    headers: (params) => ({
+      Authorization: `Bearer ${params.accessToken}`,
+      'Content-Type': 'application/json',
+    }),
+    body: (params) => {
+      const data: Record<string, unknown> = {
+        title: params.title,
+        api_slug: params.apiSlug,
+        description: params.description ?? null,
+        type: params.type,
+        is_required: params.isRequired ?? false,
+        is_unique: params.isUnique ?? false,
+        is_multiselect: params.isMultiselect ?? false,
+        // `config` is a required key on Attio's create-attribute request body (even though its
+        // nested fields are only required for type-dependent configs like currency/record-reference).
+        config: {},
+      }
+      if (params.config) {
+        try {
+          data.config =
+            typeof params.config === 'string' ? JSON.parse(params.config) : params.config
+        } catch {
+          throw new Error('Invalid JSON provided for attribute config')
+        }
+      }
+      return { data }
+    },
+  },
+
+  transformResponse: async (response) => {
+    const data = await response.json()
+    if (!response.ok) {
+      logger.error('Attio API request failed', { data, status: response.status })
+      throw new Error(data.message || 'Failed to create attribute')
+    }
+    const attr = data.data
+    return {
+      success: true,
+      output: {
+        attributeId: attr.id?.attribute_id ?? null,
+        title: attr.title ?? null,
+        apiSlug: attr.api_slug ?? null,
+        description: attr.description ?? null,
+        type: attr.type ?? null,
+        isSystemAttribute: attr.is_system_attribute ?? false,
+        isWritable: attr.is_writable ?? false,
+        isRequired: attr.is_required ?? false,
+        isUnique: attr.is_unique ?? false,
+        isMultiselect: attr.is_multiselect ?? false,
+        isDefaultValueEnabled: attr.is_default_value_enabled ?? false,
+        isArchived: attr.is_archived ?? false,
+        defaultValue: attr.default_value ?? null,
+        relationship: attr.relationship ?? null,
+        config: attr.config ?? null,
+        createdAt: attr.created_at ?? null,
+      },
+    }
+  },
+
+  outputs: ATTRIBUTE_OUTPUT_PROPERTIES,
+}

apps/sim/tools/attio/create_comment.ts

@@ -52,21 +52,37 @@ export const attioCreateCommentTool: ToolConfig<
     },
     list: {
       type: 'string',
-      required: true,
+      required: false,
       visibility: 'user-or-llm',
-      description: 'The list ID or slug the entry belongs to',
+      description:
+        'The list ID or slug the entry belongs to (used with entryId; omit if threadId or recordId is set)',
     },
     entryId: {
       type: 'string',
-      required: true,
+      required: false,
+      visibility: 'user-or-llm',
+      description:
+        'The list entry ID to comment on (used with list; omit if threadId or recordId is set)',
+    },
+    recordObject: {
+      type: 'string',
+      required: false,
       visibility: 'user-or-llm',
-      description: 'The entry ID to comment on',
+      description:
+        'The object ID or slug the record belongs to (used with recordId; omit if threadId or entryId is set)',
+    },
+    recordId: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description:
+        'The record ID to comment on directly (used with recordObject; omit if threadId or entryId is set)',
     },
     threadId: {
       type: 'string',
       required: false,
       visibility: 'user-or-llm',
-      description: 'Thread ID to reply to (omit to start a new thread)',
+      description: 'Thread ID to reply to (omit to start a new thread on a record or list entry)',
     },
     createdAt: {
       type: 'string',
@@ -91,12 +107,25 @@ export const attioCreateCommentTool: ToolConfig<
           type: params.authorType,
           id: params.authorId,
         },
-        entry: {
+      }
+      // Attio's comment body accepts exactly one of `thread_id`, `record`, or `entry` — mutually exclusive.
+      if (params.threadId) {
+        data.thread_id = params.threadId
+      } else if (params.recordObject && params.recordId) {
+        data.record = {
+          object: params.recordObject,
+          record_id: params.recordId,
+        }
+      } else if (params.list && params.entryId) {
+        data.entry = {
           list: params.list,
           entry_id: params.entryId,
-        },
+        }
+      } else {
+        throw new Error(
+          'Must provide either threadId, both recordObject and recordId, or both list and entryId'
+        )
       }
-      if (params.threadId) data.thread_id = params.threadId
       if (params.createdAt) data.created_at = params.createdAt
       return { data }
     },

apps/sim/tools/attio/create_note.ts

@@ -1,7 +1,7 @@
 import { createLogger } from '@sim/logger'
 import type { ToolConfig } from '@/tools/types'
 import type { AttioCreateNoteParams, AttioCreateNoteResponse } from './types'
-import { NOTE_OUTPUT_PROPERTIES } from './types'
+import { mapNoteTags, NOTE_OUTPUT_PROPERTIES } from './types'
 
 const logger = createLogger('AttioCreateNote')
 
@@ -105,7 +105,7 @@ export const attioCreateNoteTool: ToolConfig<AttioCreateNoteParams, AttioCreateN
         contentPlaintext: note.content_plaintext ?? null,
         contentMarkdown: note.content_markdown ?? null,
         meetingId: note.meeting_id ?? null,
-        tags: note.tags ?? [],
+        tags: mapNoteTags(note.tags),
         createdByActor: note.created_by_actor ?? null,
         createdAt: note.created_at ?? null,
       },

apps/sim/tools/attio/create_record.ts

@@ -50,7 +50,7 @@ export const attioCreateRecordTool: ToolConfig<AttioCreateRecordParams, AttioCre
         try {
           values = typeof params.values === 'string' ? JSON.parse(params.values) : params.values
         } catch {
-          values = {}
+          throw new Error('Invalid JSON provided for record values')
         }
         return { data: { values } }
       },

apps/sim/tools/attio/create_task.ts

@@ -124,6 +124,7 @@ export const attioCreateTaskTool: ToolConfig<AttioCreateTaskParams, AttioCreateT
         content: task.content_plaintext ?? null,
         deadlineAt: task.deadline_at ?? null,
         isCompleted: task.is_completed ?? false,
+        completedAt: task.completed_at ?? null,
         linkedRecords,
         assignees,
         createdByActor: task.created_by_actor ?? null,

apps/sim/tools/attio/get_attribute.ts

@@ -0,0 +1,87 @@
+import { createLogger } from '@sim/logger'
+import type { ToolConfig } from '@/tools/types'
+import type { AttioGetAttributeParams, AttioGetAttributeResponse } from './types'
+import { ATTRIBUTE_OUTPUT_PROPERTIES } from './types'
+
+const logger = createLogger('AttioGetAttribute')
+
+export const attioGetAttributeTool: ToolConfig<AttioGetAttributeParams, AttioGetAttributeResponse> =
+  {
+    id: 'attio_get_attribute',
+    name: 'Attio Get Attribute',
+    description: 'Get a single attribute (schema field) on an Attio object or list',
+    version: '1.0.0',
+
+    oauth: {
+      required: true,
+      provider: 'attio',
+    },
+
+    params: {
+      accessToken: {
+        type: 'string',
+        required: true,
+        visibility: 'hidden',
+        description: 'The OAuth access token for the Attio API',
+      },
+      target: {
+        type: 'string',
+        required: true,
+        visibility: 'user-or-llm',
+        description: 'Whether the attribute belongs to an object or a list: objects or lists',
+      },
+      identifier: {
+        type: 'string',
+        required: true,
+        visibility: 'user-or-llm',
+        description: 'The object or list ID or slug (e.g. people, companies)',
+      },
+      attribute: {
+        type: 'string',
+        required: true,
+        visibility: 'user-or-llm',
+        description: 'The attribute ID or slug',
+      },
+    },
+
+    request: {
+      url: (params) =>
+        `https://api.attio.com/v2/${params.target.trim()}/${params.identifier.trim()}/attributes/${params.attribute.trim()}`,
+      method: 'GET',
+      headers: (params) => ({
+        Authorization: `Bearer ${params.accessToken}`,
+      }),
+    },
+
+    transformResponse: async (response) => {
+      const data = await response.json()
+      if (!response.ok) {
+        logger.error('Attio API request failed', { data, status: response.status })
+        throw new Error(data.message || 'Failed to get attribute')
+      }
+      const attr = data.data
+      return {
+        success: true,
+        output: {
+          attributeId: attr.id?.attribute_id ?? null,
+          title: attr.title ?? null,
+          apiSlug: attr.api_slug ?? null,
+          description: attr.description ?? null,
+          type: attr.type ?? null,
+          isSystemAttribute: attr.is_system_attribute ?? false,
+          isWritable: attr.is_writable ?? false,
+          isRequired: attr.is_required ?? false,
+          isUnique: attr.is_unique ?? false,
+          isMultiselect: attr.is_multiselect ?? false,
+          isDefaultValueEnabled: attr.is_default_value_enabled ?? false,
+          isArchived: attr.is_archived ?? false,
+          defaultValue: attr.default_value ?? null,
+          relationship: attr.relationship ?? null,
+          config: attr.config ?? null,
+          createdAt: attr.created_at ?? null,
+        },
+      }
+    },
+
+    outputs: ATTRIBUTE_OUTPUT_PROPERTIES,
+  }

apps/sim/tools/attio/get_note.ts

@@ -1,7 +1,7 @@
 import { createLogger } from '@sim/logger'
 import type { ToolConfig } from '@/tools/types'
 import type { AttioGetNoteParams, AttioGetNoteResponse } from './types'
-import { NOTE_OUTPUT_PROPERTIES } from './types'
+import { mapNoteTags, NOTE_OUTPUT_PROPERTIES } from './types'
 
 const logger = createLogger('AttioGetNote')
 
@@ -56,7 +56,7 @@ export const attioGetNoteTool: ToolConfig<AttioGetNoteParams, AttioGetNoteRespon
         contentPlaintext: note.content_plaintext ?? null,
         contentMarkdown: note.content_markdown ?? null,
         meetingId: note.meeting_id ?? null,
-        tags: note.tags ?? [],
+        tags: mapNoteTags(note.tags),
         createdByActor: note.created_by_actor ?? null,
         createdAt: note.created_at ?? null,
       },