@vellumai/assistant 0.4.29 → 0.4.30

package/src/config/bundled-skills/messaging/TOOLS.json

@@ -12,6 +12,10 @@
           "platform": {
             "type": "string",
             "description": "Platform to test (e.g. \"slack\", \"gmail\"). Auto-detected if only one is connected."
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         }
       },
@@ -34,18 +38,17 @@
             "type": "array",
             "items": {
               "type": "string",
-              "enum": [
-                "channel",
-                "dm",
-                "group",
-                "inbox"
-              ]
+              "enum": ["channel", "dm", "group", "inbox"]
             },
             "description": "Filter by conversation type"
           },
           "limit": {
             "type": "number",
             "description": "Maximum number of conversations to return (default 200)"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         }
       },
@@ -75,11 +78,13 @@
           "limit": {
             "type": "number",
             "description": "Maximum number of messages to return (default 50)"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
-        "required": [
-          "conversation_id"
-        ]
+        "required": ["conversation_id"]
       },
       "executor": "tools/messaging-read.ts",
       "execution_target": "host"
@@ -103,11 +108,13 @@
           "max_results": {
             "type": "number",
             "description": "Maximum number of results to return (default 20)"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
-        "required": [
-          "query"
-        ]
+        "required": ["query"]
       },
       "executor": "tools/messaging-search.ts",
       "execution_target": "host"
@@ -143,13 +150,13 @@
           "confidence": {
             "type": "number",
             "description": "Confidence score (0-1) for this action"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
-        "required": [
-          "conversation_id",
-          "text",
-          "confidence"
-        ]
+        "required": ["conversation_id", "text", "confidence"]
       },
       "executor": "tools/messaging-send.ts",
       "execution_target": "host"
@@ -181,14 +188,13 @@
           "confidence": {
             "type": "number",
             "description": "Confidence score (0-1) for this action"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
-        "required": [
-          "conversation_id",
-          "thread_id",
-          "text",
-          "confidence"
-        ]
+        "required": ["conversation_id", "thread_id", "text", "confidence"]
       },
       "executor": "tools/messaging-reply.ts",
       "execution_target": "host"
@@ -212,11 +218,13 @@
           "message_id": {
             "type": "string",
             "description": "Specific message ID to mark as read (optional)"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
-        "required": [
-          "conversation_id"
-        ]
+        "required": ["conversation_id"]
       },
       "executor": "tools/messaging-mark-read.ts",
       "execution_target": "host"
@@ -232,6 +240,10 @@
           "platform": {
             "type": "string",
             "description": "Platform (e.g. \"slack\", \"gmail\"). Auto-detected if only one is connected."
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         }
       },
@@ -257,6 +269,10 @@
           "query_filter": {
             "type": "string",
             "description": "Optional search filter (e.g. 'to:alice@example.com' for Gmail, 'from:@me' for Slack)"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         }
       },
@@ -273,11 +289,7 @@
         "properties": {
           "action": {
             "type": "string",
-            "enum": [
-              "create",
-              "list",
-              "delete"
-            ],
+            "enum": ["create", "list", "delete"],
             "description": "Draft operation"
           },
           "platform": {
@@ -303,11 +315,13 @@
           "draft_id": {
             "type": "string",
             "description": "Draft ID (for delete)"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
-        "required": [
-          "action"
-        ]
+        "required": ["action"]
       },
       "executor": "tools/messaging-draft.ts",
       "execution_target": "host"
@@ -327,12 +341,13 @@
           "confidence": {
             "type": "number",
             "description": "Confidence score (0-1) for this action"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
-        "required": [
-          "message_id",
-          "confidence"
-        ]
+        "required": ["message_id", "confidence"]
       },
       "executor": "tools/gmail-archive.ts",
       "execution_target": "host"
@@ -361,16 +376,18 @@
             "items": {
               "type": "string"
             },
-            "description": "Gmail message IDs to archive (fallback — prefer scan_id + sender_ids)"
+            "description": "Gmail message IDs to archive (fallback \u2014 prefer scan_id + sender_ids)"
           },
           "confidence": {
             "type": "number",
             "description": "Confidence score (0-1) for this action"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
-        "required": [
-          "confidence"
-        ]
+        "required": ["confidence"]
       },
       "executor": "tools/gmail-batch-archive.ts",
       "execution_target": "host"
@@ -390,12 +407,13 @@
           "confidence": {
             "type": "number",
             "description": "Confidence score (0-1) for this action"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
-        "required": [
-          "query",
-          "confidence"
-        ]
+        "required": ["query", "confidence"]
       },
       "executor": "tools/gmail-archive-by-query.ts",
       "execution_target": "host"
@@ -429,12 +447,13 @@
           "confidence": {
             "type": "number",
             "description": "Confidence score (0-1) for this action"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
-        "required": [
-          "message_id",
-          "confidence"
-        ]
+        "required": ["message_id", "confidence"]
       },
       "executor": "tools/gmail-label.ts",
       "execution_target": "host"
@@ -471,12 +490,13 @@
           "confidence": {
             "type": "number",
             "description": "Confidence score (0-1) for this action"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
-        "required": [
-          "message_ids",
-          "confidence"
-        ]
+        "required": ["message_ids", "confidence"]
       },
       "executor": "tools/gmail-batch-label.ts",
       "execution_target": "host"
@@ -496,12 +516,13 @@
           "confidence": {
             "type": "number",
             "description": "Confidence score (0-1) for this action"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
-        "required": [
-          "message_id",
-          "confidence"
-        ]
+        "required": ["message_id", "confidence"]
       },
       "executor": "tools/gmail-trash.ts",
       "execution_target": "host"
@@ -521,12 +542,13 @@
           "confidence": {
             "type": "number",
             "description": "Confidence score (0-1) for this action"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
-        "required": [
-          "message_id",
-          "confidence"
-        ]
+        "required": ["message_id", "confidence"]
       },
       "executor": "tools/gmail-unsubscribe.ts",
       "execution_target": "host"
@@ -562,13 +584,13 @@
           "bcc": {
             "type": "string",
             "description": "BCC recipients (comma-separated email addresses)"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
-        "required": [
-          "to",
-          "subject",
-          "body"
-        ]
+        "required": ["to", "subject", "body"]
       },
       "executor": "tools/gmail-draft.ts",
       "execution_target": "host"
@@ -588,12 +610,13 @@
           "confidence": {
             "type": "number",
             "description": "Confidence score (0-1) for this action"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
-        "required": [
-          "draft_id",
-          "confidence"
-        ]
+        "required": ["draft_id", "confidence"]
       },
       "executor": "tools/gmail-send-draft.ts",
       "execution_target": "host"
@@ -609,11 +632,13 @@
           "message_id": {
             "type": "string",
             "description": "Gmail message ID to list attachments for"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
-        "required": [
-          "message_id"
-        ]
+        "required": ["message_id"]
       },
       "executor": "tools/gmail-list-attachments.ts",
       "execution_target": "host"
@@ -637,13 +662,13 @@
           "filename": {
             "type": "string",
             "description": "Filename to save as"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
-        "required": [
-          "message_id",
-          "attachment_id",
-          "filename"
-        ]
+        "required": ["message_id", "attachment_id", "filename"]
       },
       "executor": "tools/gmail-download-attachment.ts",
       "execution_target": "host"
@@ -686,15 +711,13 @@
           "confidence": {
             "type": "number",
             "description": "Confidence score (0-1) for this action"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
-        "required": [
-          "to",
-          "subject",
-          "body",
-          "attachment_paths",
-          "confidence"
-        ]
+        "required": ["to", "subject", "body", "attachment_paths", "confidence"]
       },
       "executor": "tools/gmail-send-with-attachments.ts",
       "execution_target": "host"
@@ -722,13 +745,13 @@
           "confidence": {
             "type": "number",
             "description": "Confidence score (0-1) for this action"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
-        "required": [
-          "message_id",
-          "to",
-          "confidence"
-        ]
+        "required": ["message_id", "to", "confidence"]
       },
       "executor": "tools/gmail-forward.ts",
       "execution_target": "host"
@@ -744,11 +767,13 @@
           "thread_id": {
             "type": "string",
             "description": "Gmail thread ID to summarize"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
-        "required": [
-          "thread_id"
-        ]
+        "required": ["thread_id"]
       },
       "executor": "tools/gmail-summarize-thread.ts",
       "execution_target": "host"
@@ -763,11 +788,7 @@
         "properties": {
           "action": {
             "type": "string",
-            "enum": [
-              "track",
-              "list",
-              "untrack"
-            ],
+            "enum": ["track", "list", "untrack"],
             "description": "Follow-up action"
           },
           "message_id": {
@@ -777,12 +798,13 @@
           "confidence": {
             "type": "number",
             "description": "Confidence score (0-1) for this action"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
-        "required": [
-          "action",
-          "confidence"
-        ]
+        "required": ["action", "confidence"]
       },
       "executor": "tools/gmail-follow-up.ts",
       "execution_target": "host"
@@ -810,11 +832,13 @@
           "confidence": {
             "type": "number",
             "description": "Confidence score (0-1) for this action"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
-        "required": [
-          "confidence"
-        ]
+        "required": ["confidence"]
       },
       "executor": "tools/gmail-triage.ts",
       "execution_target": "host"
@@ -829,11 +853,7 @@
         "properties": {
           "action": {
             "type": "string",
-            "enum": [
-              "list",
-              "create",
-              "delete"
-            ],
+            "enum": ["list", "create", "delete"],
             "description": "Filter action"
           },
           "from": {
@@ -881,12 +901,13 @@
           "confidence": {
             "type": "number",
             "description": "Confidence score (0-1) for this action"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
-        "required": [
-          "action",
-          "confidence"
-        ]
+        "required": ["action", "confidence"]
       },
       "executor": "tools/gmail-filters.ts",
       "execution_target": "host"
@@ -901,11 +922,7 @@
         "properties": {
           "action": {
             "type": "string",
-            "enum": [
-              "get",
-              "enable",
-              "disable"
-            ],
+            "enum": ["get", "enable", "disable"],
             "description": "Vacation action"
           },
           "message": {
@@ -935,12 +952,13 @@
           "confidence": {
             "type": "number",
             "description": "Confidence score (0-1) for this action"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
-        "required": [
-          "action",
-          "confidence"
-        ]
+        "required": ["action", "confidence"]
       },
       "executor": "tools/gmail-vacation.ts",
       "execution_target": "host"
@@ -967,7 +985,11 @@
           },
           "page_token": {
             "type": "string",
-            "description": "Resume token from a previous scan (rarely needed — scans now cover up to 10,000 messages in a single call)"
+            "description": "Resume token from a previous scan (rarely needed \u2014 scans now cover up to 10,000 messages in a single call)"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         }
       },
@@ -1000,7 +1022,11 @@
           },
           "page_token": {
             "type": "string",
-            "description": "Resume token from a previous scan (rarely needed — scans now cover up to 5,000 messages in a single call)"
+            "description": "Resume token from a previous scan (rarely needed \u2014 scans now cover up to 5,000 messages in a single call)"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         }
       },
@@ -1026,12 +1052,13 @@
           "confidence": {
             "type": "number",
             "description": "Confidence score (0-1) for this action"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
-        "required": [
-          "query",
-          "confidence"
-        ]
+        "required": ["query", "confidence"]
       },
       "executor": "tools/messaging-archive-by-sender.ts",
       "execution_target": "host"
@@ -1062,7 +1089,11 @@
           },
           "page_token": {
             "type": "string",
-            "description": "Resume token from a previous scan (rarely needed — scans now cover up to 5,000 messages in a single call)"
+            "description": "Resume token from a previous scan (rarely needed \u2014 scans now cover up to 5,000 messages in a single call)"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         }
       },
@@ -1079,10 +1110,7 @@
         "properties": {
           "action": {
             "type": "string",
-            "enum": [
-              "list",
-              "search"
-            ],
+            "enum": ["list", "search"],
             "description": "Contacts action"
           },
           "query": {
@@ -1096,11 +1124,13 @@
           "page_token": {
             "type": "string",
             "description": "Pagination token (for list)"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
-        "required": [
-          "action"
-        ]
+        "required": ["action"]
       },
       "executor": "tools/google-contacts.ts",
       "execution_target": "host"
@@ -1147,9 +1177,7 @@
                   "description": "Whether to require user approval before sending (default false)"
                 }
               },
-              "required": [
-                "body_prompt"
-              ]
+              "required": ["body_prompt"]
             },
             "description": "Ordered list of sequence steps"
           },
@@ -1160,13 +1188,13 @@
           "exit_on_reply": {
             "type": "boolean",
             "description": "Whether to stop the sequence when the contact replies (default true)"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
-        "required": [
-          "name",
-          "channel",
-          "steps"
-        ]
+        "required": ["name", "channel", "steps"]
       },
       "executor": "tools/sequence-create.ts",
       "execution_target": "host"
@@ -1181,12 +1209,12 @@
         "properties": {
           "status": {
             "type": "string",
-            "enum": [
-              "active",
-              "paused",
-              "archived"
-            ],
+            "enum": ["active", "paused", "archived"],
             "description": "Filter by sequence status"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         }
       },
@@ -1204,11 +1232,13 @@
           "id": {
             "type": "string",
             "description": "Sequence ID"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
-        "required": [
-          "id"
-        ]
+        "required": ["id"]
       },
       "executor": "tools/sequence-get.ts",
       "execution_target": "host"
@@ -1235,11 +1265,7 @@
           },
           "status": {
             "type": "string",
-            "enum": [
-              "active",
-              "paused",
-              "archived"
-            ],
+            "enum": ["active", "paused", "archived"],
             "description": "New status"
           },
           "exit_on_reply": {
@@ -1272,16 +1298,16 @@
                   "description": "Whether to require user approval before sending"
                 }
               },
-              "required": [
-                "body_prompt"
-              ]
+              "required": ["body_prompt"]
             },
             "description": "Replacement steps (replaces all existing steps)"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
-        "required": [
-          "id"
-        ]
+        "required": ["id"]
       },
       "executor": "tools/sequence-update.ts",
       "execution_target": "host"
@@ -1297,11 +1323,13 @@
           "id": {
             "type": "string",
             "description": "Sequence ID to delete"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
-        "required": [
-          "id"
-        ]
+        "required": ["id"]
       },
       "executor": "tools/sequence-delete.ts",
       "execution_target": "host"
@@ -1335,12 +1363,13 @@
           "context": {
             "type": "object",
             "description": "Optional context object with personalization variables for the enrolled contacts"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
-        "required": [
-          "sequence_id",
-          "emails"
-        ]
+        "required": ["sequence_id", "emails"]
       },
       "executor": "tools/sequence-enroll.ts",
       "execution_target": "host"
@@ -1368,6 +1397,10 @@
               "failed"
             ],
             "description": "Filter by enrollment status"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         }
       },
@@ -1389,6 +1422,10 @@
           "enrollment_id": {
             "type": "string",
             "description": "Specific enrollment ID to cancel (alternative to pausing whole sequence)"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         }
       },
@@ -1406,11 +1443,13 @@
           "sequence_id": {
             "type": "string",
             "description": "Sequence ID to resume"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
-        "required": [
-          "sequence_id"
-        ]
+        "required": ["sequence_id"]
       },
       "executor": "tools/sequence-resume.ts",
       "execution_target": "host"
@@ -1426,11 +1465,13 @@
           "enrollment_id": {
             "type": "string",
             "description": "Enrollment ID to cancel"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
-        "required": [
-          "enrollment_id"
-        ]
+        "required": ["enrollment_id"]
       },
       "executor": "tools/sequence-cancel.ts",
       "execution_target": "host"
@@ -1454,12 +1495,13 @@
           "auto_enroll": {
             "type": "boolean",
             "description": "Set to true to enroll contacts (default false = preview mode)"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
-        "required": [
-          "file_path",
-          "sequence_id"
-        ]
+        "required": ["file_path", "sequence_id"]
       },
       "executor": "tools/sequence-import.ts",
       "execution_target": "host"
@@ -1475,6 +1517,10 @@
           "sequence_id": {
             "type": "string",
             "description": "Optional sequence ID for detailed step funnel view"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         }
       },