feat(tools): added clay tools/block (#326)

Author: aadamgough

docs/content/docs/tools/clay.mdx

@@ -4,6 +4,7 @@
     "airtable",
     "autoblocks",
     "browser_use",
+    "clay",
     "confluence",
     "dropdown",
     "elevenlabs",

docs/content/docs/tools/meta.json

@@ -0,0 +1,58 @@
+import { ClayIcon } from '@/components/icons'
+import { ClayPopulateResponse } from '@/tools/clay/types'
+import { BlockConfig } from '../types'
+
+export const ClayBlock: BlockConfig<ClayPopulateResponse> = {
+  type: 'clay',
+  name: 'Clay',
+  description: 'Populate Clay workbook with data',
+  longDescription:
+    'Populate Clay workbook with data using a JSON or plain text. Enables direct communication and notifications with channel confirmation.',
+  category: 'tools',
+  bgColor: '#E0E0E0',
+  icon: ClayIcon,
+  subBlocks: [
+    {
+      id: 'webhookURL',
+      title: 'Webhook URL',
+      type: 'short-input',
+      layout: 'full',
+      placeholder: 'Enter Clay webhook URL',
+    },
+    {
+      id: 'data',
+      title: 'Data (JSON or Plain Text)',
+      type: 'long-input',
+      layout: 'full',
+      placeholder: 'Enter your JSON data to populate your Clay table',
+      description: `JSON vs. Plain Text:
+JSON: Best for populating multiple columns.
+Plain Text: Best for populating a table in free-form style.
+      `,
+    },
+    {
+      id: 'authToken',
+      title: 'Auth Token',
+      type: 'short-input',
+      layout: 'full',
+      placeholder: 'Enter your Clay Auth token',
+      password: true,
+      connectionDroppable: false,
+    },
+  ],
+  tools: {
+    access: ['clay_populate'],
+  },
+  inputs: {
+    authToken: { type: 'string', required: true },
+    webhookURL: { type: 'string', required: true },
+    data: { type: 'json', required: true },
+  },
+  outputs: {
+    response: {
+      type: {
+        data: 'any',
+      },
+    },
+  },
+}

sim/blocks/blocks/clay.ts

@@ -49,6 +49,7 @@ import { BlockConfig } from './types'
 import { Mem0Block } from './blocks/mem0'
 import { S3Block } from './blocks/s3'
 import { TelegramBlock } from './blocks/telegram'
+import { ClayBlock } from './blocks/clay'
 
 // Export blocks for ease of use
 export {
@@ -101,6 +102,7 @@ export {
   StagehandAgentBlock,
   S3Block,
   TelegramBlock,
+  ClayBlock,
 }
 
 // Registry of all block configurations, alphabetically sorted
@@ -154,6 +156,7 @@ const blocks: Record<string, BlockConfig> = {
   x: XBlock,
   youtube: YouTubeBlock,
   telegram: TelegramBlock,
+  clay: ClayBlock,
 }
 
 // Helper functions

sim/blocks/index.ts

@@ -0,0 +1,3 @@
+import { clayPopulateTool } from './populate'
+
+export { clayPopulateTool }

sim/components/icons.tsx

@@ -0,0 +1,72 @@
+import { ToolConfig } from '../types'
+import { ClayPopulateParams, ClayPopulateResponse } from './types'
+
+export const clayPopulateTool: ToolConfig<ClayPopulateParams, ClayPopulateResponse> = {
+  id: 'clay_populate',
+  name: 'Clay Populate',
+  description:
+    'Populate Clay with data from a JSON file. Enables direct communication and notifications with timestamp tracking and channel confirmation.',
+  version: '1.0.0',
+
+  params: {
+    webhookURL: {
+      type: 'string',
+      required: true,
+      requiredForToolCall: true,
+      description: 'The webhook URL to populate',
+    },
+    data: {
+      type: 'json',
+      required: true,
+      description: 'The data to populate',
+      optionalToolInput: true,
+    },
+    authToken: {
+      type: 'string',
+      required: false,
+      description: 'Optional auth token for WebhookURL',
+    },
+  },
+
+  request: {
+    url: (params: ClayPopulateParams) => params.webhookURL,
+    method: 'POST',
+    headers: (params: ClayPopulateParams) => ({
+      'Content-Type': 'application/json',
+      Authorization: `Bearer ${params.authToken}`,
+    }),
+    body: (params: ClayPopulateParams) => ({
+      data: params.data,
+    }),
+  },
+
+  transformResponse: async (response: Response) => {
+    const contentType = response.headers.get('content-type')
+    let data
+    
+    if (contentType?.includes('application/json')) {
+      data = await response.json()
+      if (!data.ok) {
+        throw new Error(data.error || 'Clay API error')
+      }
+    } else {
+      // Handle text response
+      data = await response.text()
+      if (data !== 'OK' && !response.ok) {
+        throw new Error(data || 'Clay API error')
+      }
+    }
+
+    return {
+      success: true,
+      output: {
+        data: contentType?.includes('application/json') ? data : { message: data },
+      },
+    }
+  },
+
+  transformError: (error: any) => {
+    const message = error.message || 'Clay populate failed'
+    return message
+  },
+}

sim/tools/clay/index.ts

@@ -0,0 +1,13 @@
+import { ToolResponse } from "../types"
+
+export interface ClayPopulateParams {
+    webhookURL: string
+    data: JSON
+    authToken?: string
+}
+
+export interface ClayPopulateResponse extends ToolResponse {
+    output: {
+        data: any
+    }
+}

sim/tools/clay/populate.ts

@@ -42,6 +42,7 @@ import { ToolConfig } from './types'
 import { s3GetObjectTool } from './s3'
 import { jiraRetrieveTool, jiraUpdateTool, jiraWriteTool, jiraBulkRetrieveTool } from './jira'
 import { telegramMessageTool } from './telegram'
+import { clayPopulateTool } from './clay'
 
 // Registry of all available tools
 export const tools: Record<string, ToolConfig> = {
@@ -128,4 +129,5 @@ export const tools: Record<string, ToolConfig> = {
   elevenlabs_tts: elevenLabsTtsTool,
   s3_get_object: s3GetObjectTool,
   telegram_message: telegramMessageTool,
+  clay_populate: clayPopulateTool,
 }