improvement(integrations): tighten sixtyfour, agentmail, agentphone outputs (#4765)

* improvement(integrations): tighten sixtyfour, agentmail, agentphone outputs

* fix(agentphone): expose mediaUrls in block outputs

* fix(sixtyfour): remove invalid `properties` field from block outputs

* chore(skills): clarify validate-integration block vs tool outputs

Author: waleedlatif1

.agents/skills/validate-integration/SKILL.md

@@ -102,8 +102,8 @@ For **every** tool file, check:
 - [ ] No fields are missing that the API provides and users would commonly need
 - [ ] No phantom fields defined that the API doesn't return
 - [ ] `optional: true` is set on fields that may not exist in all responses
-- [ ] When using `type: 'json'` and the shape is known, `properties` defines the inner fields
-- [ ] When using `type: 'array'`, `items` defines the item structure with `properties`
+- [ ] When using `type: 'json'` and the shape is known, `properties` defines the inner fields (tool outputs only — block outputs do not support `properties`)
+- [ ] When using `type: 'array'`, `items` defines the item structure with `properties` (tool outputs only)
 - [ ] Field descriptions are accurate and helpful
 
 ### Types (types.ts)
@@ -190,9 +190,8 @@ For **each tool** in `tools.access`:
 ### Block Outputs
 - [ ] Outputs cover the key fields returned by ALL tools (not just one operation)
 - [ ] Output types are correct (`'string'`, `'number'`, `'boolean'`, `'json'`)
-- [ ] `type: 'json'` outputs either:
-  - Describe inner fields in the description string (GOOD): `'User profile (id, name, username, bio)'`
-  - Use nested output definitions (BEST): `{ id: { type: 'string' }, name: { type: 'string' } }`
+- [ ] `type: 'json'` outputs describe inner fields in the description string: `'User profile (id, name, username, bio)'` or `'[{address, status, type}]'` for arrays
+- [ ] **Do NOT add a `properties: {...}` field on block outputs.** Block-level `OutputFieldDefinition` (from `@sim/workflow-types/blocks`) only accepts `{ type, description?, condition?, hiddenFromDisplay? }`. Nested `properties` is a tool-level construct (`OutputProperty`) — adding it to a block output will fail TypeScript at build time
 - [ ] No opaque `type: 'json'` with vague descriptions like `'Response data'`
 - [ ] Outputs that only appear for certain operations use `condition` if supported, or document which operations return them
 

.claude/commands/validate-integration.md

@@ -87,8 +87,8 @@ For **every** tool file, check:
 - [ ] No fields are missing that the API provides and users would commonly need
 - [ ] No phantom fields defined that the API doesn't return
 - [ ] `optional: true` is set on fields that may not exist in all responses
-- [ ] When using `type: 'json'` and the shape is known, `properties` defines the inner fields
-- [ ] When using `type: 'array'`, `items` defines the item structure with `properties`
+- [ ] When using `type: 'json'` and the shape is known, `properties` defines the inner fields (tool outputs only — block outputs do not support `properties`)
+- [ ] When using `type: 'array'`, `items` defines the item structure with `properties` (tool outputs only)
 - [ ] Field descriptions are accurate and helpful
 
 ### Types (types.ts)
@@ -175,9 +175,8 @@ For **each tool** in `tools.access`:
 ### Block Outputs
 - [ ] Outputs cover the key fields returned by ALL tools (not just one operation)
 - [ ] Output types are correct (`'string'`, `'number'`, `'boolean'`, `'json'`)
-- [ ] `type: 'json'` outputs either:
-  - Describe inner fields in the description string (GOOD): `'User profile (id, name, username, bio)'`
-  - Use nested output definitions (BEST): `{ id: { type: 'string' }, name: { type: 'string' } }`
+- [ ] `type: 'json'` outputs describe inner fields in the description string: `'User profile (id, name, username, bio)'` or `'[{address, status, type}]'` for arrays
+- [ ] **Do NOT add a `properties: {...}` field on block outputs.** Block-level `OutputFieldDefinition` (from `@sim/workflow-types/blocks`) only accepts `{ type, description?, condition?, hiddenFromDisplay? }`. Nested `properties` is a tool-level construct (`OutputProperty`) — adding it to a block output will fail TypeScript at build time
 - [ ] No opaque `type: 'json'` with vague descriptions like `'Response data'`
 - [ ] Outputs that only appear for certain operations use `condition` if supported, or document which operations return them
 

.cursor/commands/validate-integration.md

@@ -82,8 +82,8 @@ For **every** tool file, check:
 - [ ] No fields are missing that the API provides and users would commonly need
 - [ ] No phantom fields defined that the API doesn't return
 - [ ] `optional: true` is set on fields that may not exist in all responses
-- [ ] When using `type: 'json'` and the shape is known, `properties` defines the inner fields
-- [ ] When using `type: 'array'`, `items` defines the item structure with `properties`
+- [ ] When using `type: 'json'` and the shape is known, `properties` defines the inner fields (tool outputs only — block outputs do not support `properties`)
+- [ ] When using `type: 'array'`, `items` defines the item structure with `properties` (tool outputs only)
 - [ ] Field descriptions are accurate and helpful
 
 ### Types (types.ts)
@@ -170,9 +170,8 @@ For **each tool** in `tools.access`:
 ### Block Outputs
 - [ ] Outputs cover the key fields returned by ALL tools (not just one operation)
 - [ ] Output types are correct (`'string'`, `'number'`, `'boolean'`, `'json'`)
-- [ ] `type: 'json'` outputs either:
-  - Describe inner fields in the description string (GOOD): `'User profile (id, name, username, bio)'`
-  - Use nested output definitions (BEST): `{ id: { type: 'string' }, name: { type: 'string' } }`
+- [ ] `type: 'json'` outputs describe inner fields in the description string: `'User profile (id, name, username, bio)'` or `'[{address, status, type}]'` for arrays
+- [ ] **Do NOT add a `properties: {...}` field on block outputs.** Block-level `OutputFieldDefinition` (from `@sim/workflow-types/blocks`) only accepts `{ type, description?, condition?, hiddenFromDisplay? }`. Nested `properties` is a tool-level construct (`OutputProperty`) — adding it to a block output will fail TypeScript at build time
 - [ ] No opaque `type: 'json'` with vague descriptions like `'Response data'`
 - [ ] Outputs that only appear for certain operations use `condition` if supported, or document which operations return them
 

apps/sim/blocks/blocks/agentmail.ts

@@ -193,9 +193,9 @@ export const AgentMailBlock: BlockConfig = {
     },
     {
       id: 'replyTo',
-      title: 'Override To',
+      title: 'Override Recipients',
       type: 'short-input',
-      placeholder: 'Override recipient (optional)',
+      placeholder: 'Override recipient (comma-separated)',
       condition: { field: 'operation', value: 'reply_message' },
       mode: 'advanced',
     },
@@ -349,6 +349,7 @@ export const AgentMailBlock: BlockConfig = {
       type: 'short-input',
       placeholder: 'Optional username for email address',
       condition: { field: 'operation', value: 'create_inbox' },
+      mode: 'advanced',
     },
     {
       id: 'domain',
@@ -564,7 +565,7 @@ export const AgentMailBlock: BlockConfig = {
     cc: { type: 'string', description: 'CC email addresses' },
     bcc: { type: 'string', description: 'BCC email addresses' },
     replyMessageId: { type: 'string', description: 'Message ID to reply to' },
-    replyTo: { type: 'string', description: 'Override recipient for reply' },
+    replyTo: { type: 'string', description: 'Override recipients for reply (comma-separated)' },
     replyAll: { type: 'string', description: 'Reply to all recipients' },
     forwardMessageId: { type: 'string', description: 'Message ID to forward' },
     updateMessageId: { type: 'string', description: 'Message ID to update labels on' },
@@ -603,7 +604,8 @@ export const AgentMailBlock: BlockConfig = {
     preview: { type: 'string', description: 'Message or draft preview text' },
     senders: { type: 'json', description: 'List of sender email addresses' },
     recipients: { type: 'json', description: 'List of recipient email addresses' },
-    labels: { type: 'json', description: 'Thread or draft labels' },
+    labels: { type: 'json', description: 'Thread, message, or draft labels' },
+    timestamp: { type: 'string', description: 'Time the message was sent or drafted' },
     messages: { type: 'json', description: 'List of messages' },
     threads: { type: 'json', description: 'List of threads' },
     inboxes: { type: 'json', description: 'List of inboxes' },

apps/sim/blocks/blocks/agentphone.ts

@@ -700,6 +700,7 @@ export const AgentPhoneBlock: BlockConfig = {
     from_: { type: 'string', description: 'Sender phone number on a number message' },
     body: { type: 'string', description: 'Message body text' },
     mediaUrl: { type: 'string', description: 'Attached media URL' },
+    mediaUrls: { type: 'json', description: 'Attached media URLs (array)' },
     receivedAt: { type: 'string', description: 'ISO 8601 timestamp' },
     participant: { type: 'string', description: 'External participant phone number' },
     lastMessageAt: { type: 'string', description: 'ISO 8601 timestamp' },
@@ -712,7 +713,7 @@ export const AgentPhoneBlock: BlockConfig = {
     messages: {
       type: 'json',
       description:
-        'Conversation messages: [{id, body, fromNumber, toNumber, direction, channel, mediaUrl, receivedAt}]',
+        'Conversation messages: [{id, body, fromNumber, toNumber, direction, channel, mediaUrl, mediaUrls, receivedAt}]',
     },
     reactionType: { type: 'string', description: 'Reaction type applied' },
     messageId: { type: 'string', description: 'Message ID' },

apps/sim/blocks/blocks/sixtyfour.ts

@@ -265,11 +265,13 @@ export const SixtyfourBlock: BlockConfig = {
     },
     emails: {
       type: 'json',
-      description: 'Email addresses found with validation status and type (find_email)',
+      description:
+        'Email addresses found (find_email): [{address, status (OK|UNKNOWN|NOT_FOUND), type (COMPANY|PERSONAL)}]',
     },
     personalEmails: {
       type: 'json',
-      description: 'Personal email addresses found in PERSONAL mode (find_email)',
+      description:
+        'Personal email addresses found in PERSONAL mode (find_email): [{address, status, type}]',
     },
     notes: {
       type: 'string',
@@ -288,5 +290,9 @@ export const SixtyfourBlock: BlockConfig = {
       type: 'number',
       description: 'Quality score for the returned data, 0-10 (enrich_lead, enrich_company)',
     },
+    orgChart: {
+      type: 'json',
+      description: 'Org chart returned when fullOrgChart is enabled (enrich_company)',
+    },
   },
 }

apps/sim/tools/agentmail/get_message.ts

@@ -54,6 +54,8 @@ export const agentmailGetMessageTool: ToolConfig<GetMessageParams, GetMessageRes
           subject: null,
           text: null,
           html: null,
+          labels: [],
+          timestamp: null,
           createdAt: '',
         },
       }
@@ -71,6 +73,8 @@ export const agentmailGetMessageTool: ToolConfig<GetMessageParams, GetMessageRes
         subject: data.subject ?? null,
         text: data.text ?? null,
         html: data.html ?? null,
+        labels: data.labels ?? [],
+        timestamp: data.timestamp ?? null,
         createdAt: data.created_at ?? '',
       },
     }
@@ -86,6 +90,12 @@ export const agentmailGetMessageTool: ToolConfig<GetMessageParams, GetMessageRes
     subject: { type: 'string', description: 'Message subject', optional: true },
     text: { type: 'string', description: 'Plain text content', optional: true },
     html: { type: 'string', description: 'HTML content', optional: true },
+    labels: { type: 'array', description: 'Labels assigned to the message' },
+    timestamp: {
+      type: 'string',
+      description: 'Time the message was sent or drafted',
+      optional: true,
+    },
     createdAt: { type: 'string', description: 'Creation timestamp' },
   },
 }

apps/sim/tools/agentmail/get_thread.ts

@@ -80,6 +80,8 @@ export const agentmailGetThreadTool: ToolConfig<GetThreadParams, GetThreadResult
           subject: (msg.subject as string) ?? null,
           text: (msg.text as string) ?? null,
           html: (msg.html as string) ?? null,
+          labels: (msg.labels as string[]) ?? [],
+          timestamp: (msg.timestamp as string) ?? null,
           createdAt: (msg.created_at as string) ?? '',
         })),
       },
@@ -110,6 +112,12 @@ export const agentmailGetThreadTool: ToolConfig<GetThreadParams, GetThreadResult
           subject: { type: 'string', description: 'Message subject', optional: true },
           text: { type: 'string', description: 'Plain text content', optional: true },
           html: { type: 'string', description: 'HTML content', optional: true },
+          labels: { type: 'array', description: 'Labels assigned to the message' },
+          timestamp: {
+            type: 'string',
+            description: 'Time the message was sent or drafted',
+            optional: true,
+          },
           createdAt: { type: 'string', description: 'Creation timestamp' },
         },
       },

apps/sim/tools/agentmail/list_messages.ts

@@ -68,6 +68,7 @@ export const agentmailListMessagesTool: ToolConfig<ListMessagesParams, ListMessa
           to: (msg.to as string[]) ?? [],
           subject: (msg.subject as string) ?? null,
           preview: (msg.preview as string) ?? null,
+          timestamp: (msg.timestamp as string) ?? null,
           createdAt: (msg.created_at as string) ?? '',
         })),
         count: data.count ?? 0,
@@ -88,6 +89,11 @@ export const agentmailListMessagesTool: ToolConfig<ListMessagesParams, ListMessa
           to: { type: 'array', description: 'Recipient email addresses' },
           subject: { type: 'string', description: 'Message subject', optional: true },
           preview: { type: 'string', description: 'Message preview text', optional: true },
+          timestamp: {
+            type: 'string',
+            description: 'Time the message was sent or drafted',
+            optional: true,
+          },
           createdAt: { type: 'string', description: 'Creation timestamp' },
         },
       },

apps/sim/tools/agentmail/types.ts

@@ -366,6 +366,8 @@ export interface GetThreadResult extends ToolResponse {
       subject: string | null
       text: string | null
       html: string | null
+      labels: string[]
+      timestamp: string | null
       createdAt: string
     }>
   }
@@ -417,6 +419,7 @@ export interface ListMessagesResult extends ToolResponse {
       to: string[]
       subject: string | null
       preview: string | null
+      timestamp: string | null
       createdAt: string
     }>
     count: number
@@ -442,6 +445,8 @@ export interface GetMessageResult extends ToolResponse {
     subject: string | null
     text: string | null
     html: string | null
+    labels: string[]
+    timestamp: string | null
     createdAt: string
   }
 }