@oomol-lab/open-connector 1.7.0 → 1.9.0

package/assets/open-connector/catalog/apps/gmail.json

@@ -13,12 +13,17 @@
       "type": "oauth2",
       "authorizationUrl": "https://accounts.google.com/o/oauth2/v2/auth",
       "tokenUrl": "https://oauth2.googleapis.com/token",
+      "revocationUrl": "https://oauth2.googleapis.com/revoke",
       "scopes": [
         "https://www.googleapis.com/auth/gmail.readonly",
         "https://www.googleapis.com/auth/gmail.modify",
         "https://www.googleapis.com/auth/gmail.labels",
         "https://www.googleapis.com/auth/gmail.settings.basic"
       ],
+      "optionalScopes": [
+        "https://www.googleapis.com/auth/gmail.compose",
+        "https://www.googleapis.com/auth/gmail.send"
+      ],
       "tokenEndpointAuthMethod": "client_secret_post",
       "authorizationParams": {
         "access_type": "offline",
@@ -166,20 +171,97 @@
               {
                 "type": "null"
               }
-            ]
+            ],
+            "description": "Gmail API object."
           },
           "messageText": {
             "type": "string",
-            "description": "Extracted message body text."
+            "description": "Extracted message body; HTML is preferred when both HTML and plain-text alternatives are present."
           },
           "attachmentList": {
             "type": "array",
             "items": {
               "type": "object",
-              "additionalProperties": true,
-              "description": "Gmail API object."
+              "properties": {
+                "attachmentId": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "Gmail attachment ID, or null when bytes are stored directly in the message part."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Gmail attachment ID, or null when bytes are stored directly in the message part."
+                },
+                "filename": {
+                  "type": "string",
+                  "description": "Attachment filename; empty for unnamed parts."
+                },
+                "mimeType": {
+                  "type": "string",
+                  "description": "Attachment MIME type."
+                },
+                "size": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "description": "Attachment size in bytes."
+                },
+                "partId": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "Gmail MIME part ID when supplied."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Gmail MIME part ID when supplied."
+                },
+                "contentId": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "Bare Content-ID without angle brackets, when supplied."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Bare Content-ID without angle brackets, when supplied."
+                },
+                "disposition": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "enum": [
+                        "inline",
+                        "attachment"
+                      ],
+                      "description": "Content-Disposition when supplied and recognized."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Content-Disposition when supplied and recognized."
+                }
+              },
+              "additionalProperties": false,
+              "required": [
+                "attachmentId",
+                "filename",
+                "mimeType",
+                "size",
+                "partId",
+                "contentId",
+                "disposition"
+              ],
+              "description": "Attachment or inline resource metadata from a Gmail MIME part."
             },
-            "description": "Message attachments."
+            "description": "Message attachments and inline resources, including unnamed CID parts."
           },
           "raw": {
             "type": "string",
@@ -267,7 +349,7 @@
       "id": "gmail.create_draft",
       "service": "gmail",
       "name": "create_draft",
-      "description": "Create a Gmail draft with a simplified input and output shape.",
+      "description": "Create a Gmail draft with optional attachments and CID inline images using simplified input fields. Returns the stable draft ID and current message and thread IDs.",
       "operationType": "write",
       "requiredScopes": [
         "https://www.googleapis.com/auth/gmail.compose"
@@ -297,6 +379,103 @@
                 }
               }
             ]
+          },
+          "isHtml": {
+            "type": "boolean",
+            "description": "Whether the draft body is HTML."
+          },
+          "attachments": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "filename": {
+                  "type": "string",
+                  "description": "Attachment filename. Omit for an unnamed Base64 attachment; defaults to the transit file name."
+                },
+                "mimeType": {
+                  "type": "string",
+                  "description": "Attachment MIME type as type/subtype without parameters. Defaults to the transit file MIME type or application/octet-stream."
+                },
+                "contentBase64": {
+                  "type": "string",
+                  "description": "Standard Base64 file content. An empty string represents a zero-byte file. Supply exactly one of contentBase64 or file."
+                },
+                "file": {
+                  "type": "object",
+                  "properties": {
+                    "fileId": {
+                      "type": "string",
+                      "minLength": 1,
+                      "description": "The transit file identifier returned by POST /api/files."
+                    },
+                    "name": {
+                      "type": "string",
+                      "minLength": 1,
+                      "description": "Optional filename override to send to the provider."
+                    },
+                    "mimeType": {
+                      "type": "string",
+                      "minLength": 1,
+                      "description": "Optional MIME type override to send to the provider."
+                    }
+                  },
+                  "additionalProperties": false,
+                  "required": [
+                    "fileId"
+                  ],
+                  "description": "An uploaded transit file. Supply exactly one of file or contentBase64."
+                },
+                "contentId": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "Bare Content-ID without cid: or angle brackets. Reference it in HTML as cid:<contentId>."
+                },
+                "disposition": {
+                  "type": "string",
+                  "enum": [
+                    "inline",
+                    "attachment"
+                  ],
+                  "description": "Defaults to inline when contentId is present, otherwise attachment. Inline attachments require contentId."
+                }
+              },
+              "additionalProperties": false,
+              "description": "An email attachment or CID inline image.",
+              "oneOf": [
+                {
+                  "required": [
+                    "contentBase64"
+                  ]
+                },
+                {
+                  "required": [
+                    "file"
+                  ]
+                }
+              ],
+              "allOf": [
+                {
+                  "if": {
+                    "properties": {
+                      "disposition": {
+                        "const": "inline"
+                      }
+                    },
+                    "required": [
+                      "disposition"
+                    ]
+                  },
+                  "then": {
+                    "required": [
+                      "contentId"
+                    ]
+                  }
+                }
+              ]
+            },
+            "description": "Email attachments and CID inline images, up to 25000000 decoded bytes in total and 35000000 bytes for the complete MIME message. Provide file bytes or a transit file reference; HTML image conversion is performed by the caller.",
+            "maxItems": 100
           }
         },
         "additionalProperties": false,
@@ -314,6 +493,16 @@
             "type": "string",
             "minLength": 1,
             "description": "Gmail draft ID."
+          },
+          "messageId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Gmail message ID."
+          },
+          "threadId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Gmail thread ID."
           }
         },
         "additionalProperties": false,
@@ -327,7 +516,7 @@
       "id": "gmail.create_email_draft",
       "service": "gmail",
       "name": "create_email_draft",
-      "description": "Create a Gmail draft with recipients, subject, body, and optional threading.",
+      "description": "Create a Gmail draft with optional attachments or CID inline images. Supply replyToMessageId to reply to a message, or threadId to reply to its most recent non-draft message. Threaded creation additionally requires mailbox read access. Omit subject and To recipients to inherit them from the reply target; a supplied subject must match the target, ignoring Re: prefixes.",
       "operationType": "write",
       "requiredScopes": [
         "https://www.googleapis.com/auth/gmail.compose"
@@ -395,6 +584,99 @@
             "type": "boolean",
             "description": "Whether the body is HTML."
           },
+          "attachments": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "filename": {
+                  "type": "string",
+                  "description": "Attachment filename. Omit for an unnamed Base64 attachment; defaults to the transit file name."
+                },
+                "mimeType": {
+                  "type": "string",
+                  "description": "Attachment MIME type as type/subtype without parameters. Defaults to the transit file MIME type or application/octet-stream."
+                },
+                "contentBase64": {
+                  "type": "string",
+                  "description": "Standard Base64 file content. An empty string represents a zero-byte file. Supply exactly one of contentBase64 or file."
+                },
+                "file": {
+                  "type": "object",
+                  "properties": {
+                    "fileId": {
+                      "type": "string",
+                      "minLength": 1,
+                      "description": "The transit file identifier returned by POST /api/files."
+                    },
+                    "name": {
+                      "type": "string",
+                      "minLength": 1,
+                      "description": "Optional filename override to send to the provider."
+                    },
+                    "mimeType": {
+                      "type": "string",
+                      "minLength": 1,
+                      "description": "Optional MIME type override to send to the provider."
+                    }
+                  },
+                  "additionalProperties": false,
+                  "required": [
+                    "fileId"
+                  ],
+                  "description": "An uploaded transit file. Supply exactly one of file or contentBase64."
+                },
+                "contentId": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "Bare Content-ID without cid: or angle brackets. Reference it in HTML as cid:<contentId>."
+                },
+                "disposition": {
+                  "type": "string",
+                  "enum": [
+                    "inline",
+                    "attachment"
+                  ],
+                  "description": "Defaults to inline when contentId is present, otherwise attachment. Inline attachments require contentId."
+                }
+              },
+              "additionalProperties": false,
+              "description": "An email attachment or CID inline image.",
+              "oneOf": [
+                {
+                  "required": [
+                    "contentBase64"
+                  ]
+                },
+                {
+                  "required": [
+                    "file"
+                  ]
+                }
+              ],
+              "allOf": [
+                {
+                  "if": {
+                    "properties": {
+                      "disposition": {
+                        "const": "inline"
+                      }
+                    },
+                    "required": [
+                      "disposition"
+                    ]
+                  },
+                  "then": {
+                    "required": [
+                      "contentId"
+                    ]
+                  }
+                }
+              ]
+            },
+            "description": "Email attachments and CID inline images, up to 25000000 decoded bytes in total and 35000000 bytes for the complete MIME message. Provide file bytes or a transit file reference; HTML image conversion is performed by the caller.",
+            "maxItems": 100
+          },
           "fromEmail": {
             "type": "string",
             "description": "Verified Gmail send-as alias."
@@ -403,6 +685,11 @@
             "type": "string",
             "minLength": 1,
             "description": "Gmail thread ID."
+          },
+          "replyToMessageId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Gmail message ID to reply to. Requires mailbox read access. If threadId is also supplied, it must match this message's thread."
           }
         },
         "additionalProperties": false,
@@ -1011,20 +1298,97 @@
                         {
                           "type": "null"
                         }
-                      ]
+                      ],
+                      "description": "Gmail API object."
                     },
                     "messageText": {
                       "type": "string",
-                      "description": "Extracted message body text."
+                      "description": "Extracted message body; HTML is preferred when both HTML and plain-text alternatives are present."
                     },
                     "attachmentList": {
                       "type": "array",
                       "items": {
                         "type": "object",
-                        "additionalProperties": true,
-                        "description": "Gmail API object."
+                        "properties": {
+                          "attachmentId": {
+                            "anyOf": [
+                              {
+                                "type": "string",
+                                "description": "Gmail attachment ID, or null when bytes are stored directly in the message part."
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ],
+                            "description": "Gmail attachment ID, or null when bytes are stored directly in the message part."
+                          },
+                          "filename": {
+                            "type": "string",
+                            "description": "Attachment filename; empty for unnamed parts."
+                          },
+                          "mimeType": {
+                            "type": "string",
+                            "description": "Attachment MIME type."
+                          },
+                          "size": {
+                            "type": "integer",
+                            "minimum": 0,
+                            "description": "Attachment size in bytes."
+                          },
+                          "partId": {
+                            "anyOf": [
+                              {
+                                "type": "string",
+                                "description": "Gmail MIME part ID when supplied."
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ],
+                            "description": "Gmail MIME part ID when supplied."
+                          },
+                          "contentId": {
+                            "anyOf": [
+                              {
+                                "type": "string",
+                                "description": "Bare Content-ID without angle brackets, when supplied."
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ],
+                            "description": "Bare Content-ID without angle brackets, when supplied."
+                          },
+                          "disposition": {
+                            "anyOf": [
+                              {
+                                "type": "string",
+                                "enum": [
+                                  "inline",
+                                  "attachment"
+                                ],
+                                "description": "Content-Disposition when supplied and recognized."
+                              },
+                              {
+                                "type": "null"
+                              }
+                            ],
+                            "description": "Content-Disposition when supplied and recognized."
+                          }
+                        },
+                        "additionalProperties": false,
+                        "required": [
+                          "attachmentId",
+                          "filename",
+                          "mimeType",
+                          "size",
+                          "partId",
+                          "contentId",
+                          "disposition"
+                        ],
+                        "description": "Attachment or inline resource metadata from a Gmail MIME part."
                       },
-                      "description": "Message attachments."
+                      "description": "Message attachments and inline resources, including unnamed CID parts."
                     },
                     "raw": {
                       "type": "string",
@@ -1061,7 +1425,8 @@
               {
                 "type": "null"
               }
-            ]
+            ],
+            "description": "Opaque pagination token returned by Gmail."
           },
           "resultSizeEstimate": {
             "type": "integer",
@@ -1178,20 +1543,97 @@
               {
                 "type": "null"
               }
-            ]
+            ],
+            "description": "Gmail API object."
           },
           "messageText": {
             "type": "string",
-            "description": "Extracted message body text."
+            "description": "Extracted message body; HTML is preferred when both HTML and plain-text alternatives are present."
           },
           "attachmentList": {
             "type": "array",
             "items": {
               "type": "object",
-              "additionalProperties": true,
-              "description": "Gmail API object."
+              "properties": {
+                "attachmentId": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "Gmail attachment ID, or null when bytes are stored directly in the message part."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Gmail attachment ID, or null when bytes are stored directly in the message part."
+                },
+                "filename": {
+                  "type": "string",
+                  "description": "Attachment filename; empty for unnamed parts."
+                },
+                "mimeType": {
+                  "type": "string",
+                  "description": "Attachment MIME type."
+                },
+                "size": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "description": "Attachment size in bytes."
+                },
+                "partId": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "Gmail MIME part ID when supplied."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Gmail MIME part ID when supplied."
+                },
+                "contentId": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "Bare Content-ID without angle brackets, when supplied."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Bare Content-ID without angle brackets, when supplied."
+                },
+                "disposition": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "enum": [
+                        "inline",
+                        "attachment"
+                      ],
+                      "description": "Content-Disposition when supplied and recognized."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Content-Disposition when supplied and recognized."
+                }
+              },
+              "additionalProperties": false,
+              "required": [
+                "attachmentId",
+                "filename",
+                "mimeType",
+                "size",
+                "partId",
+                "contentId",
+                "disposition"
+              ],
+              "description": "Attachment or inline resource metadata from a Gmail MIME part."
             },
-            "description": "Message attachments."
+            "description": "Message attachments and inline resources, including unnamed CID parts."
           },
           "raw": {
             "type": "string",
@@ -1253,7 +1695,8 @@
               {
                 "type": "null"
               }
-            ]
+            ],
+            "description": "Mailbox history checkpoint ID."
           },
           "snippet": {
             "type": "string",
@@ -1329,24 +1772,101 @@
                     {
                       "type": "null"
                     }
-                  ]
+                  ],
+                  "description": "Gmail API object."
                 },
                 "messageText": {
                   "type": "string",
-                  "description": "Extracted message body text."
+                  "description": "Extracted message body; HTML is preferred when both HTML and plain-text alternatives are present."
                 },
                 "attachmentList": {
                   "type": "array",
                   "items": {
                     "type": "object",
-                    "additionalProperties": true,
-                    "description": "Gmail API object."
-                  },
-                  "description": "Message attachments."
-                },
-                "raw": {
-                  "type": "string",
-                  "description": "Raw RFC 2822 message when requested."
+                    "properties": {
+                      "attachmentId": {
+                        "anyOf": [
+                          {
+                            "type": "string",
+                            "description": "Gmail attachment ID, or null when bytes are stored directly in the message part."
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ],
+                        "description": "Gmail attachment ID, or null when bytes are stored directly in the message part."
+                      },
+                      "filename": {
+                        "type": "string",
+                        "description": "Attachment filename; empty for unnamed parts."
+                      },
+                      "mimeType": {
+                        "type": "string",
+                        "description": "Attachment MIME type."
+                      },
+                      "size": {
+                        "type": "integer",
+                        "minimum": 0,
+                        "description": "Attachment size in bytes."
+                      },
+                      "partId": {
+                        "anyOf": [
+                          {
+                            "type": "string",
+                            "description": "Gmail MIME part ID when supplied."
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ],
+                        "description": "Gmail MIME part ID when supplied."
+                      },
+                      "contentId": {
+                        "anyOf": [
+                          {
+                            "type": "string",
+                            "description": "Bare Content-ID without angle brackets, when supplied."
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ],
+                        "description": "Bare Content-ID without angle brackets, when supplied."
+                      },
+                      "disposition": {
+                        "anyOf": [
+                          {
+                            "type": "string",
+                            "enum": [
+                              "inline",
+                              "attachment"
+                            ],
+                            "description": "Content-Disposition when supplied and recognized."
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ],
+                        "description": "Content-Disposition when supplied and recognized."
+                      }
+                    },
+                    "additionalProperties": false,
+                    "required": [
+                      "attachmentId",
+                      "filename",
+                      "mimeType",
+                      "size",
+                      "partId",
+                      "contentId",
+                      "disposition"
+                    ],
+                    "description": "Attachment or inline resource metadata from a Gmail MIME part."
+                  },
+                  "description": "Message attachments and inline resources, including unnamed CID parts."
+                },
+                "raw": {
+                  "type": "string",
+                  "description": "Raw RFC 2822 message when requested."
                 }
               },
               "additionalProperties": true,
@@ -1509,20 +2029,97 @@
                   {
                     "type": "null"
                   }
-                ]
+                ],
+                "description": "Gmail API object."
               },
               "messageText": {
                 "type": "string",
-                "description": "Extracted message body text."
+                "description": "Extracted message body; HTML is preferred when both HTML and plain-text alternatives are present."
               },
               "attachmentList": {
                 "type": "array",
                 "items": {
                   "type": "object",
-                  "additionalProperties": true,
-                  "description": "Gmail API object."
+                  "properties": {
+                    "attachmentId": {
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "description": "Gmail attachment ID, or null when bytes are stored directly in the message part."
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "Gmail attachment ID, or null when bytes are stored directly in the message part."
+                    },
+                    "filename": {
+                      "type": "string",
+                      "description": "Attachment filename; empty for unnamed parts."
+                    },
+                    "mimeType": {
+                      "type": "string",
+                      "description": "Attachment MIME type."
+                    },
+                    "size": {
+                      "type": "integer",
+                      "minimum": 0,
+                      "description": "Attachment size in bytes."
+                    },
+                    "partId": {
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "description": "Gmail MIME part ID when supplied."
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "Gmail MIME part ID when supplied."
+                    },
+                    "contentId": {
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "description": "Bare Content-ID without angle brackets, when supplied."
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "Bare Content-ID without angle brackets, when supplied."
+                    },
+                    "disposition": {
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "enum": [
+                            "inline",
+                            "attachment"
+                          ],
+                          "description": "Content-Disposition when supplied and recognized."
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "Content-Disposition when supplied and recognized."
+                    }
+                  },
+                  "additionalProperties": false,
+                  "required": [
+                    "attachmentId",
+                    "filename",
+                    "mimeType",
+                    "size",
+                    "partId",
+                    "contentId",
+                    "disposition"
+                  ],
+                  "description": "Attachment or inline resource metadata from a Gmail MIME part."
                 },
-                "description": "Message attachments."
+                "description": "Message attachments and inline resources, including unnamed CID parts."
               },
               "raw": {
                 "type": "string",
@@ -1900,112 +2497,210 @@
                   "description": "Gmail draft ID."
                 },
                 "message": {
-                  "type": "object",
-                  "properties": {
-                    "messageId": {
-                      "type": "string",
-                      "minLength": 1,
-                      "description": "Gmail message ID."
-                    },
-                    "threadId": {
-                      "type": "string",
-                      "minLength": 1,
-                      "description": "Gmail thread ID."
-                    },
-                    "labelIds": {
-                      "type": "array",
-                      "items": {
-                        "type": "string",
-                        "minLength": 1
-                      },
-                      "description": "Gmail label IDs."
-                    },
-                    "subject": {
-                      "type": "string",
-                      "description": "Message subject."
-                    },
-                    "sender": {
-                      "type": "string",
-                      "description": "Message sender."
-                    },
-                    "to": {
-                      "type": "string",
-                      "description": "Message recipients."
-                    },
-                    "messageTimestamp": {
-                      "type": "string",
-                      "description": "Message timestamp."
-                    },
-                    "historyId": {
-                      "type": "string",
-                      "description": "Gmail history ID when the resource carries one."
-                    },
-                    "internalDate": {
-                      "type": "string",
-                      "description": "Gmail internal date as epoch milliseconds when present."
-                    },
-                    "sizeEstimate": {
-                      "type": "integer",
-                      "description": "Estimated message size in bytes when present."
-                    },
-                    "snippet": {
-                      "type": "string",
-                      "description": "Gmail snippet when present."
-                    },
-                    "preview": {
+                  "anyOf": [
+                    {
                       "type": "object",
-                      "additionalProperties": true,
-                      "description": "Gmail API object."
-                    },
-                    "payload": {
-                      "anyOf": [
-                        {
+                      "properties": {
+                        "messageId": {
+                          "type": "string",
+                          "minLength": 1,
+                          "description": "Gmail message ID."
+                        },
+                        "threadId": {
+                          "type": "string",
+                          "minLength": 1,
+                          "description": "Gmail thread ID."
+                        },
+                        "labelIds": {
+                          "type": "array",
+                          "items": {
+                            "type": "string",
+                            "minLength": 1
+                          },
+                          "description": "Gmail label IDs."
+                        },
+                        "subject": {
+                          "type": "string",
+                          "description": "Message subject."
+                        },
+                        "sender": {
+                          "type": "string",
+                          "description": "Message sender."
+                        },
+                        "to": {
+                          "type": "string",
+                          "description": "Message recipients."
+                        },
+                        "messageTimestamp": {
+                          "type": "string",
+                          "description": "Message timestamp."
+                        },
+                        "historyId": {
+                          "type": "string",
+                          "description": "Gmail history ID when the resource carries one."
+                        },
+                        "internalDate": {
+                          "type": "string",
+                          "description": "Gmail internal date as epoch milliseconds when present."
+                        },
+                        "sizeEstimate": {
+                          "type": "integer",
+                          "description": "Estimated message size in bytes when present."
+                        },
+                        "snippet": {
+                          "type": "string",
+                          "description": "Gmail snippet when present."
+                        },
+                        "preview": {
                           "type": "object",
                           "additionalProperties": true,
                           "description": "Gmail API object."
                         },
-                        {
-                          "type": "null"
+                        "payload": {
+                          "anyOf": [
+                            {
+                              "type": "object",
+                              "additionalProperties": true,
+                              "description": "Gmail API object."
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ],
+                          "description": "Gmail API object."
+                        },
+                        "messageText": {
+                          "type": "string",
+                          "description": "Extracted message body; HTML is preferred when both HTML and plain-text alternatives are present."
+                        },
+                        "attachmentList": {
+                          "type": "array",
+                          "items": {
+                            "type": "object",
+                            "properties": {
+                              "attachmentId": {
+                                "anyOf": [
+                                  {
+                                    "type": "string",
+                                    "description": "Gmail attachment ID, or null when bytes are stored directly in the message part."
+                                  },
+                                  {
+                                    "type": "null"
+                                  }
+                                ],
+                                "description": "Gmail attachment ID, or null when bytes are stored directly in the message part."
+                              },
+                              "filename": {
+                                "type": "string",
+                                "description": "Attachment filename; empty for unnamed parts."
+                              },
+                              "mimeType": {
+                                "type": "string",
+                                "description": "Attachment MIME type."
+                              },
+                              "size": {
+                                "type": "integer",
+                                "minimum": 0,
+                                "description": "Attachment size in bytes."
+                              },
+                              "partId": {
+                                "anyOf": [
+                                  {
+                                    "type": "string",
+                                    "description": "Gmail MIME part ID when supplied."
+                                  },
+                                  {
+                                    "type": "null"
+                                  }
+                                ],
+                                "description": "Gmail MIME part ID when supplied."
+                              },
+                              "contentId": {
+                                "anyOf": [
+                                  {
+                                    "type": "string",
+                                    "description": "Bare Content-ID without angle brackets, when supplied."
+                                  },
+                                  {
+                                    "type": "null"
+                                  }
+                                ],
+                                "description": "Bare Content-ID without angle brackets, when supplied."
+                              },
+                              "disposition": {
+                                "anyOf": [
+                                  {
+                                    "type": "string",
+                                    "enum": [
+                                      "inline",
+                                      "attachment"
+                                    ],
+                                    "description": "Content-Disposition when supplied and recognized."
+                                  },
+                                  {
+                                    "type": "null"
+                                  }
+                                ],
+                                "description": "Content-Disposition when supplied and recognized."
+                              }
+                            },
+                            "additionalProperties": false,
+                            "required": [
+                              "attachmentId",
+                              "filename",
+                              "mimeType",
+                              "size",
+                              "partId",
+                              "contentId",
+                              "disposition"
+                            ],
+                            "description": "Attachment or inline resource metadata from a Gmail MIME part."
+                          },
+                          "description": "Message attachments and inline resources, including unnamed CID parts."
+                        },
+                        "raw": {
+                          "type": "string",
+                          "description": "Raw RFC 2822 message when requested."
                         }
-                      ]
-                    },
-                    "messageText": {
-                      "type": "string",
-                      "description": "Extracted message body text."
-                    },
-                    "attachmentList": {
-                      "type": "array",
-                      "items": {
-                        "type": "object",
-                        "additionalProperties": true,
-                        "description": "Gmail API object."
                       },
-                      "description": "Message attachments."
+                      "additionalProperties": true,
+                      "required": [
+                        "messageId",
+                        "threadId",
+                        "labelIds",
+                        "subject",
+                        "sender",
+                        "to",
+                        "messageTimestamp"
+                      ],
+                      "description": "Normalized Gmail message."
                     },
-                    "raw": {
-                      "type": "string",
-                      "description": "Raw RFC 2822 message when requested."
+                    {
+                      "type": "object",
+                      "properties": {
+                        "messageId": {
+                          "type": "string",
+                          "minLength": 1,
+                          "description": "Gmail message ID."
+                        },
+                        "threadId": {
+                          "type": "string",
+                          "minLength": 1,
+                          "description": "Gmail thread ID."
+                        }
+                      },
+                      "additionalProperties": false,
+                      "description": "Draft message IDs returned when verbose is false."
                     }
-                  },
-                  "additionalProperties": true,
-                  "required": [
-                    "messageId",
-                    "threadId",
-                    "labelIds",
-                    "subject",
-                    "sender",
-                    "to",
-                    "messageTimestamp"
-                  ],
-                  "description": "Normalized Gmail message."
+                  ]
                 }
               },
-              "additionalProperties": true,
+              "additionalProperties": false,
               "required": [
                 "id",
                 "message"
               ],
-              "description": "Gmail draft."
+              "description": "Draft with message IDs or hydrated message details."
             }
           },
           "nextPageToken": {
@@ -2017,7 +2712,8 @@
               {
                 "type": "null"
               }
-            ]
+            ],
+            "description": "Opaque pagination token returned by Gmail."
           }
         },
         "additionalProperties": false,
@@ -2188,7 +2884,8 @@
               {
                 "type": "null"
               }
-            ]
+            ],
+            "description": "Opaque pagination token returned by Gmail."
           }
         },
         "additionalProperties": false,
@@ -2348,7 +3045,8 @@
                     {
                       "type": "null"
                     }
-                  ]
+                  ],
+                  "description": "Mailbox history checkpoint ID."
                 },
                 "snippet": {
                   "type": "string",
@@ -2424,20 +3122,97 @@
                           {
                             "type": "null"
                           }
-                        ]
+                        ],
+                        "description": "Gmail API object."
                       },
                       "messageText": {
                         "type": "string",
-                        "description": "Extracted message body text."
+                        "description": "Extracted message body; HTML is preferred when both HTML and plain-text alternatives are present."
                       },
                       "attachmentList": {
                         "type": "array",
                         "items": {
                           "type": "object",
-                          "additionalProperties": true,
-                          "description": "Gmail API object."
+                          "properties": {
+                            "attachmentId": {
+                              "anyOf": [
+                                {
+                                  "type": "string",
+                                  "description": "Gmail attachment ID, or null when bytes are stored directly in the message part."
+                                },
+                                {
+                                  "type": "null"
+                                }
+                              ],
+                              "description": "Gmail attachment ID, or null when bytes are stored directly in the message part."
+                            },
+                            "filename": {
+                              "type": "string",
+                              "description": "Attachment filename; empty for unnamed parts."
+                            },
+                            "mimeType": {
+                              "type": "string",
+                              "description": "Attachment MIME type."
+                            },
+                            "size": {
+                              "type": "integer",
+                              "minimum": 0,
+                              "description": "Attachment size in bytes."
+                            },
+                            "partId": {
+                              "anyOf": [
+                                {
+                                  "type": "string",
+                                  "description": "Gmail MIME part ID when supplied."
+                                },
+                                {
+                                  "type": "null"
+                                }
+                              ],
+                              "description": "Gmail MIME part ID when supplied."
+                            },
+                            "contentId": {
+                              "anyOf": [
+                                {
+                                  "type": "string",
+                                  "description": "Bare Content-ID without angle brackets, when supplied."
+                                },
+                                {
+                                  "type": "null"
+                                }
+                              ],
+                              "description": "Bare Content-ID without angle brackets, when supplied."
+                            },
+                            "disposition": {
+                              "anyOf": [
+                                {
+                                  "type": "string",
+                                  "enum": [
+                                    "inline",
+                                    "attachment"
+                                  ],
+                                  "description": "Content-Disposition when supplied and recognized."
+                                },
+                                {
+                                  "type": "null"
+                                }
+                              ],
+                              "description": "Content-Disposition when supplied and recognized."
+                            }
+                          },
+                          "additionalProperties": false,
+                          "required": [
+                            "attachmentId",
+                            "filename",
+                            "mimeType",
+                            "size",
+                            "partId",
+                            "contentId",
+                            "disposition"
+                          ],
+                          "description": "Attachment or inline resource metadata from a Gmail MIME part."
                         },
-                        "description": "Message attachments."
+                        "description": "Message attachments and inline resources, including unnamed CID parts."
                       },
                       "raw": {
                         "type": "string",
@@ -2476,7 +3251,8 @@
               {
                 "type": "null"
               }
-            ]
+            ],
+            "description": "Opaque pagination token returned by Gmail."
           },
           "resultSizeEstimate": {
             "type": "integer",
@@ -2552,7 +3328,8 @@
               {
                 "type": "null"
               }
-            ]
+            ],
+            "description": "Mailbox history checkpoint ID."
           },
           "snippet": {
             "type": "string",
@@ -2628,37 +3405,114 @@
                     {
                       "type": "null"
                     }
-                  ]
+                  ],
+                  "description": "Gmail API object."
                 },
                 "messageText": {
                   "type": "string",
-                  "description": "Extracted message body text."
+                  "description": "Extracted message body; HTML is preferred when both HTML and plain-text alternatives are present."
                 },
                 "attachmentList": {
                   "type": "array",
                   "items": {
                     "type": "object",
-                    "additionalProperties": true,
-                    "description": "Gmail API object."
-                  },
-                  "description": "Message attachments."
-                },
-                "raw": {
-                  "type": "string",
-                  "description": "Raw RFC 2822 message when requested."
-                }
-              },
-              "additionalProperties": true,
-              "required": [
-                "messageId",
-                "threadId",
-                "labelIds",
-                "subject",
-                "sender",
-                "to",
-                "messageTimestamp"
-              ],
-              "description": "Normalized Gmail message."
+                    "properties": {
+                      "attachmentId": {
+                        "anyOf": [
+                          {
+                            "type": "string",
+                            "description": "Gmail attachment ID, or null when bytes are stored directly in the message part."
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ],
+                        "description": "Gmail attachment ID, or null when bytes are stored directly in the message part."
+                      },
+                      "filename": {
+                        "type": "string",
+                        "description": "Attachment filename; empty for unnamed parts."
+                      },
+                      "mimeType": {
+                        "type": "string",
+                        "description": "Attachment MIME type."
+                      },
+                      "size": {
+                        "type": "integer",
+                        "minimum": 0,
+                        "description": "Attachment size in bytes."
+                      },
+                      "partId": {
+                        "anyOf": [
+                          {
+                            "type": "string",
+                            "description": "Gmail MIME part ID when supplied."
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ],
+                        "description": "Gmail MIME part ID when supplied."
+                      },
+                      "contentId": {
+                        "anyOf": [
+                          {
+                            "type": "string",
+                            "description": "Bare Content-ID without angle brackets, when supplied."
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ],
+                        "description": "Bare Content-ID without angle brackets, when supplied."
+                      },
+                      "disposition": {
+                        "anyOf": [
+                          {
+                            "type": "string",
+                            "enum": [
+                              "inline",
+                              "attachment"
+                            ],
+                            "description": "Content-Disposition when supplied and recognized."
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ],
+                        "description": "Content-Disposition when supplied and recognized."
+                      }
+                    },
+                    "additionalProperties": false,
+                    "required": [
+                      "attachmentId",
+                      "filename",
+                      "mimeType",
+                      "size",
+                      "partId",
+                      "contentId",
+                      "disposition"
+                    ],
+                    "description": "Attachment or inline resource metadata from a Gmail MIME part."
+                  },
+                  "description": "Message attachments and inline resources, including unnamed CID parts."
+                },
+                "raw": {
+                  "type": "string",
+                  "description": "Raw RFC 2822 message when requested."
+                }
+              },
+              "additionalProperties": true,
+              "required": [
+                "messageId",
+                "threadId",
+                "labelIds",
+                "subject",
+                "sender",
+                "to",
+                "messageTimestamp"
+              ],
+              "description": "Normalized Gmail message."
             },
             "description": "Messages in the thread."
           }
@@ -2732,7 +3586,8 @@
               {
                 "type": "null"
               }
-            ]
+            ],
+            "description": "Mailbox history checkpoint ID."
           },
           "snippet": {
             "type": "string",
@@ -2808,20 +3663,97 @@
                     {
                       "type": "null"
                     }
-                  ]
+                  ],
+                  "description": "Gmail API object."
                 },
                 "messageText": {
                   "type": "string",
-                  "description": "Extracted message body text."
+                  "description": "Extracted message body; HTML is preferred when both HTML and plain-text alternatives are present."
                 },
                 "attachmentList": {
                   "type": "array",
                   "items": {
                     "type": "object",
-                    "additionalProperties": true,
-                    "description": "Gmail API object."
+                    "properties": {
+                      "attachmentId": {
+                        "anyOf": [
+                          {
+                            "type": "string",
+                            "description": "Gmail attachment ID, or null when bytes are stored directly in the message part."
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ],
+                        "description": "Gmail attachment ID, or null when bytes are stored directly in the message part."
+                      },
+                      "filename": {
+                        "type": "string",
+                        "description": "Attachment filename; empty for unnamed parts."
+                      },
+                      "mimeType": {
+                        "type": "string",
+                        "description": "Attachment MIME type."
+                      },
+                      "size": {
+                        "type": "integer",
+                        "minimum": 0,
+                        "description": "Attachment size in bytes."
+                      },
+                      "partId": {
+                        "anyOf": [
+                          {
+                            "type": "string",
+                            "description": "Gmail MIME part ID when supplied."
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ],
+                        "description": "Gmail MIME part ID when supplied."
+                      },
+                      "contentId": {
+                        "anyOf": [
+                          {
+                            "type": "string",
+                            "description": "Bare Content-ID without angle brackets, when supplied."
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ],
+                        "description": "Bare Content-ID without angle brackets, when supplied."
+                      },
+                      "disposition": {
+                        "anyOf": [
+                          {
+                            "type": "string",
+                            "enum": [
+                              "inline",
+                              "attachment"
+                            ],
+                            "description": "Content-Disposition when supplied and recognized."
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ],
+                        "description": "Content-Disposition when supplied and recognized."
+                      }
+                    },
+                    "additionalProperties": false,
+                    "required": [
+                      "attachmentId",
+                      "filename",
+                      "mimeType",
+                      "size",
+                      "partId",
+                      "contentId",
+                      "disposition"
+                    ],
+                    "description": "Attachment or inline resource metadata from a Gmail MIME part."
                   },
-                  "description": "Message attachments."
+                  "description": "Message attachments and inline resources, including unnamed CID parts."
                 },
                 "raw": {
                   "type": "string",
@@ -2963,20 +3895,97 @@
               {
                 "type": "null"
               }
-            ]
+            ],
+            "description": "Gmail API object."
           },
           "messageText": {
             "type": "string",
-            "description": "Extracted message body text."
+            "description": "Extracted message body; HTML is preferred when both HTML and plain-text alternatives are present."
           },
           "attachmentList": {
             "type": "array",
             "items": {
               "type": "object",
-              "additionalProperties": true,
-              "description": "Gmail API object."
+              "properties": {
+                "attachmentId": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "Gmail attachment ID, or null when bytes are stored directly in the message part."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Gmail attachment ID, or null when bytes are stored directly in the message part."
+                },
+                "filename": {
+                  "type": "string",
+                  "description": "Attachment filename; empty for unnamed parts."
+                },
+                "mimeType": {
+                  "type": "string",
+                  "description": "Attachment MIME type."
+                },
+                "size": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "description": "Attachment size in bytes."
+                },
+                "partId": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "Gmail MIME part ID when supplied."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Gmail MIME part ID when supplied."
+                },
+                "contentId": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "Bare Content-ID without angle brackets, when supplied."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Bare Content-ID without angle brackets, when supplied."
+                },
+                "disposition": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "enum": [
+                        "inline",
+                        "attachment"
+                      ],
+                      "description": "Content-Disposition when supplied and recognized."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Content-Disposition when supplied and recognized."
+                }
+              },
+              "additionalProperties": false,
+              "required": [
+                "attachmentId",
+                "filename",
+                "mimeType",
+                "size",
+                "partId",
+                "contentId",
+                "disposition"
+              ],
+              "description": "Attachment or inline resource metadata from a Gmail MIME part."
             },
-            "description": "Message attachments."
+            "description": "Message attachments and inline resources, including unnamed CID parts."
           },
           "raw": {
             "type": "string",
@@ -3121,9 +4130,10 @@
       "id": "gmail.reply_email",
       "service": "gmail",
       "name": "reply_email",
-      "description": "Reply to an existing Gmail thread using the original message's reply headers.",
+      "description": "Reply to an existing Gmail thread using the original message's reply headers. Supply to to follow up with the recipient of your own sent message; omit it to reply to the original Reply-To or From address.",
       "operationType": "write",
       "requiredScopes": [
+        "https://www.googleapis.com/auth/gmail.readonly",
         "https://www.googleapis.com/auth/gmail.send"
       ],
       "providerPermissions": [],
@@ -3140,9 +4150,112 @@
             "minLength": 1,
             "description": "Gmail message ID."
           },
+          "to": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Optional recipient email address overriding the original Reply-To or From address.",
+            "format": "email"
+          },
           "body": {
             "type": "string",
             "description": "Reply body."
+          },
+          "isHtml": {
+            "type": "boolean",
+            "description": "Whether the reply body is HTML."
+          },
+          "attachments": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "filename": {
+                  "type": "string",
+                  "description": "Attachment filename. Omit for an unnamed Base64 attachment; defaults to the transit file name."
+                },
+                "mimeType": {
+                  "type": "string",
+                  "description": "Attachment MIME type as type/subtype without parameters. Defaults to the transit file MIME type or application/octet-stream."
+                },
+                "contentBase64": {
+                  "type": "string",
+                  "description": "Standard Base64 file content. An empty string represents a zero-byte file. Supply exactly one of contentBase64 or file."
+                },
+                "file": {
+                  "type": "object",
+                  "properties": {
+                    "fileId": {
+                      "type": "string",
+                      "minLength": 1,
+                      "description": "The transit file identifier returned by POST /api/files."
+                    },
+                    "name": {
+                      "type": "string",
+                      "minLength": 1,
+                      "description": "Optional filename override to send to the provider."
+                    },
+                    "mimeType": {
+                      "type": "string",
+                      "minLength": 1,
+                      "description": "Optional MIME type override to send to the provider."
+                    }
+                  },
+                  "additionalProperties": false,
+                  "required": [
+                    "fileId"
+                  ],
+                  "description": "An uploaded transit file. Supply exactly one of file or contentBase64."
+                },
+                "contentId": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "Bare Content-ID without cid: or angle brackets. Reference it in HTML as cid:<contentId>."
+                },
+                "disposition": {
+                  "type": "string",
+                  "enum": [
+                    "inline",
+                    "attachment"
+                  ],
+                  "description": "Defaults to inline when contentId is present, otherwise attachment. Inline attachments require contentId."
+                }
+              },
+              "additionalProperties": false,
+              "description": "An email attachment or CID inline image.",
+              "oneOf": [
+                {
+                  "required": [
+                    "contentBase64"
+                  ]
+                },
+                {
+                  "required": [
+                    "file"
+                  ]
+                }
+              ],
+              "allOf": [
+                {
+                  "if": {
+                    "properties": {
+                      "disposition": {
+                        "const": "inline"
+                      }
+                    },
+                    "required": [
+                      "disposition"
+                    ]
+                  },
+                  "then": {
+                    "required": [
+                      "contentId"
+                    ]
+                  }
+                }
+              ]
+            },
+            "description": "Email attachments and CID inline images, up to 25000000 decoded bytes in total and 35000000 bytes for the complete MIME message. Provide file bytes or a transit file reference; HTML image conversion is performed by the caller.",
+            "maxItems": 100
           }
         },
         "additionalProperties": false,
@@ -3160,6 +4273,11 @@
             "type": "string",
             "minLength": 1,
             "description": "Gmail message ID."
+          },
+          "threadId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Gmail thread ID."
           }
         },
         "additionalProperties": false,
@@ -3173,9 +4291,10 @@
       "id": "gmail.reply_to_thread",
       "service": "gmail",
       "name": "reply_to_thread",
-      "description": "Reply to an existing Gmail thread while preserving Gmail threading.",
+      "description": "Reply to the most recent non-draft message in an existing Gmail thread while preserving Gmail threading.",
       "operationType": "write",
       "requiredScopes": [
+        "https://www.googleapis.com/auth/gmail.readonly",
         "https://www.googleapis.com/auth/gmail.send"
       ],
       "providerPermissions": [],
@@ -3246,6 +4365,99 @@
             "type": "boolean",
             "description": "Whether the body is HTML."
           },
+          "attachments": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "filename": {
+                  "type": "string",
+                  "description": "Attachment filename. Omit for an unnamed Base64 attachment; defaults to the transit file name."
+                },
+                "mimeType": {
+                  "type": "string",
+                  "description": "Attachment MIME type as type/subtype without parameters. Defaults to the transit file MIME type or application/octet-stream."
+                },
+                "contentBase64": {
+                  "type": "string",
+                  "description": "Standard Base64 file content. An empty string represents a zero-byte file. Supply exactly one of contentBase64 or file."
+                },
+                "file": {
+                  "type": "object",
+                  "properties": {
+                    "fileId": {
+                      "type": "string",
+                      "minLength": 1,
+                      "description": "The transit file identifier returned by POST /api/files."
+                    },
+                    "name": {
+                      "type": "string",
+                      "minLength": 1,
+                      "description": "Optional filename override to send to the provider."
+                    },
+                    "mimeType": {
+                      "type": "string",
+                      "minLength": 1,
+                      "description": "Optional MIME type override to send to the provider."
+                    }
+                  },
+                  "additionalProperties": false,
+                  "required": [
+                    "fileId"
+                  ],
+                  "description": "An uploaded transit file. Supply exactly one of file or contentBase64."
+                },
+                "contentId": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "Bare Content-ID without cid: or angle brackets. Reference it in HTML as cid:<contentId>."
+                },
+                "disposition": {
+                  "type": "string",
+                  "enum": [
+                    "inline",
+                    "attachment"
+                  ],
+                  "description": "Defaults to inline when contentId is present, otherwise attachment. Inline attachments require contentId."
+                }
+              },
+              "additionalProperties": false,
+              "description": "An email attachment or CID inline image.",
+              "oneOf": [
+                {
+                  "required": [
+                    "contentBase64"
+                  ]
+                },
+                {
+                  "required": [
+                    "file"
+                  ]
+                }
+              ],
+              "allOf": [
+                {
+                  "if": {
+                    "properties": {
+                      "disposition": {
+                        "const": "inline"
+                      }
+                    },
+                    "required": [
+                      "disposition"
+                    ]
+                  },
+                  "then": {
+                    "required": [
+                      "contentId"
+                    ]
+                  }
+                }
+              ]
+            },
+            "description": "Email attachments and CID inline images, up to 25000000 decoded bytes in total and 35000000 bytes for the complete MIME message. Provide file bytes or a transit file reference; HTML image conversion is performed by the caller.",
+            "maxItems": 100
+          },
           "fromEmail": {
             "type": "string",
             "description": "Verified Gmail send-as alias."
@@ -3330,7 +4542,8 @@
                     {
                       "type": "null"
                     }
-                  ]
+                  ],
+                  "description": "Mailbox history checkpoint ID."
                 },
                 "snippet": {
                   "type": "string",
@@ -3406,20 +4619,97 @@
                           {
                             "type": "null"
                           }
-                        ]
+                        ],
+                        "description": "Gmail API object."
                       },
                       "messageText": {
                         "type": "string",
-                        "description": "Extracted message body text."
+                        "description": "Extracted message body; HTML is preferred when both HTML and plain-text alternatives are present."
                       },
                       "attachmentList": {
                         "type": "array",
                         "items": {
                           "type": "object",
-                          "additionalProperties": true,
-                          "description": "Gmail API object."
+                          "properties": {
+                            "attachmentId": {
+                              "anyOf": [
+                                {
+                                  "type": "string",
+                                  "description": "Gmail attachment ID, or null when bytes are stored directly in the message part."
+                                },
+                                {
+                                  "type": "null"
+                                }
+                              ],
+                              "description": "Gmail attachment ID, or null when bytes are stored directly in the message part."
+                            },
+                            "filename": {
+                              "type": "string",
+                              "description": "Attachment filename; empty for unnamed parts."
+                            },
+                            "mimeType": {
+                              "type": "string",
+                              "description": "Attachment MIME type."
+                            },
+                            "size": {
+                              "type": "integer",
+                              "minimum": 0,
+                              "description": "Attachment size in bytes."
+                            },
+                            "partId": {
+                              "anyOf": [
+                                {
+                                  "type": "string",
+                                  "description": "Gmail MIME part ID when supplied."
+                                },
+                                {
+                                  "type": "null"
+                                }
+                              ],
+                              "description": "Gmail MIME part ID when supplied."
+                            },
+                            "contentId": {
+                              "anyOf": [
+                                {
+                                  "type": "string",
+                                  "description": "Bare Content-ID without angle brackets, when supplied."
+                                },
+                                {
+                                  "type": "null"
+                                }
+                              ],
+                              "description": "Bare Content-ID without angle brackets, when supplied."
+                            },
+                            "disposition": {
+                              "anyOf": [
+                                {
+                                  "type": "string",
+                                  "enum": [
+                                    "inline",
+                                    "attachment"
+                                  ],
+                                  "description": "Content-Disposition when supplied and recognized."
+                                },
+                                {
+                                  "type": "null"
+                                }
+                              ],
+                              "description": "Content-Disposition when supplied and recognized."
+                            }
+                          },
+                          "additionalProperties": false,
+                          "required": [
+                            "attachmentId",
+                            "filename",
+                            "mimeType",
+                            "size",
+                            "partId",
+                            "contentId",
+                            "disposition"
+                          ],
+                          "description": "Attachment or inline resource metadata from a Gmail MIME part."
                         },
-                        "description": "Message attachments."
+                        "description": "Message attachments and inline resources, including unnamed CID parts."
                       },
                       "raw": {
                         "type": "string",
@@ -3461,10 +4751,10 @@
       "id": "gmail.send_draft",
       "service": "gmail",
       "name": "send_draft",
-      "description": "Send an existing Gmail draft as-is.",
+      "description": "Send an existing Gmail draft as-is. Gmail deletes the draft and returns the new sent message ID and its thread ID.",
       "operationType": "write",
       "requiredScopes": [
-        "https://www.googleapis.com/auth/gmail.send"
+        "https://www.googleapis.com/auth/gmail.compose"
       ],
       "providerPermissions": [],
       "inputSchema": {
@@ -3500,7 +4790,8 @@
               {
                 "type": "null"
               }
-            ]
+            ],
+            "description": "Gmail thread ID."
           }
         },
         "additionalProperties": false,
@@ -3514,7 +4805,7 @@
       "id": "gmail.send_email",
       "service": "gmail",
       "name": "send_email",
-      "description": "Send an email from the connected Gmail account.",
+      "description": "Send an email with optional attachments and CID inline images from the connected Gmail account.",
       "operationType": "write",
       "requiredScopes": [
         "https://www.googleapis.com/auth/gmail.send"
@@ -3582,6 +4873,99 @@
             "type": "boolean",
             "description": "Whether the body is HTML."
           },
+          "attachments": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "filename": {
+                  "type": "string",
+                  "description": "Attachment filename. Omit for an unnamed Base64 attachment; defaults to the transit file name."
+                },
+                "mimeType": {
+                  "type": "string",
+                  "description": "Attachment MIME type as type/subtype without parameters. Defaults to the transit file MIME type or application/octet-stream."
+                },
+                "contentBase64": {
+                  "type": "string",
+                  "description": "Standard Base64 file content. An empty string represents a zero-byte file. Supply exactly one of contentBase64 or file."
+                },
+                "file": {
+                  "type": "object",
+                  "properties": {
+                    "fileId": {
+                      "type": "string",
+                      "minLength": 1,
+                      "description": "The transit file identifier returned by POST /api/files."
+                    },
+                    "name": {
+                      "type": "string",
+                      "minLength": 1,
+                      "description": "Optional filename override to send to the provider."
+                    },
+                    "mimeType": {
+                      "type": "string",
+                      "minLength": 1,
+                      "description": "Optional MIME type override to send to the provider."
+                    }
+                  },
+                  "additionalProperties": false,
+                  "required": [
+                    "fileId"
+                  ],
+                  "description": "An uploaded transit file. Supply exactly one of file or contentBase64."
+                },
+                "contentId": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "Bare Content-ID without cid: or angle brackets. Reference it in HTML as cid:<contentId>."
+                },
+                "disposition": {
+                  "type": "string",
+                  "enum": [
+                    "inline",
+                    "attachment"
+                  ],
+                  "description": "Defaults to inline when contentId is present, otherwise attachment. Inline attachments require contentId."
+                }
+              },
+              "additionalProperties": false,
+              "description": "An email attachment or CID inline image.",
+              "oneOf": [
+                {
+                  "required": [
+                    "contentBase64"
+                  ]
+                },
+                {
+                  "required": [
+                    "file"
+                  ]
+                }
+              ],
+              "allOf": [
+                {
+                  "if": {
+                    "properties": {
+                      "disposition": {
+                        "const": "inline"
+                      }
+                    },
+                    "required": [
+                      "disposition"
+                    ]
+                  },
+                  "then": {
+                    "required": [
+                      "contentId"
+                    ]
+                  }
+                }
+              ]
+            },
+            "description": "Email attachments and CID inline images, up to 25000000 decoded bytes in total and 35000000 bytes for the complete MIME message. Provide file bytes or a transit file reference; HTML image conversion is performed by the caller.",
+            "maxItems": 100
+          },
           "fromEmail": {
             "type": "string",
             "description": "Verified Gmail send-as alias."
@@ -3597,6 +4981,11 @@
             "type": "string",
             "minLength": 1,
             "description": "Gmail message ID."
+          },
+          "threadId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Gmail thread ID."
           }
         },
         "additionalProperties": false,
@@ -3809,20 +5198,97 @@
               {
                 "type": "null"
               }
-            ]
+            ],
+            "description": "Gmail API object."
           },
           "messageText": {
             "type": "string",
-            "description": "Extracted message body text."
+            "description": "Extracted message body; HTML is preferred when both HTML and plain-text alternatives are present."
           },
           "attachmentList": {
             "type": "array",
             "items": {
               "type": "object",
-              "additionalProperties": true,
-              "description": "Gmail API object."
+              "properties": {
+                "attachmentId": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "Gmail attachment ID, or null when bytes are stored directly in the message part."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Gmail attachment ID, or null when bytes are stored directly in the message part."
+                },
+                "filename": {
+                  "type": "string",
+                  "description": "Attachment filename; empty for unnamed parts."
+                },
+                "mimeType": {
+                  "type": "string",
+                  "description": "Attachment MIME type."
+                },
+                "size": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "description": "Attachment size in bytes."
+                },
+                "partId": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "Gmail MIME part ID when supplied."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Gmail MIME part ID when supplied."
+                },
+                "contentId": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "Bare Content-ID without angle brackets, when supplied."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Bare Content-ID without angle brackets, when supplied."
+                },
+                "disposition": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "enum": [
+                        "inline",
+                        "attachment"
+                      ],
+                      "description": "Content-Disposition when supplied and recognized."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Content-Disposition when supplied and recognized."
+                }
+              },
+              "additionalProperties": false,
+              "required": [
+                "attachmentId",
+                "filename",
+                "mimeType",
+                "size",
+                "partId",
+                "contentId",
+                "disposition"
+              ],
+              "description": "Attachment or inline resource metadata from a Gmail MIME part."
             },
-            "description": "Message attachments."
+            "description": "Message attachments and inline resources, including unnamed CID parts."
           },
           "raw": {
             "type": "string",
@@ -3904,7 +5370,8 @@
               {
                 "type": "null"
               }
-            ]
+            ],
+            "description": "Mailbox history checkpoint ID."
           },
           "snippet": {
             "type": "string",
@@ -3980,20 +5447,97 @@
                     {
                       "type": "null"
                     }
-                  ]
+                  ],
+                  "description": "Gmail API object."
                 },
                 "messageText": {
                   "type": "string",
-                  "description": "Extracted message body text."
+                  "description": "Extracted message body; HTML is preferred when both HTML and plain-text alternatives are present."
                 },
                 "attachmentList": {
                   "type": "array",
                   "items": {
                     "type": "object",
-                    "additionalProperties": true,
-                    "description": "Gmail API object."
+                    "properties": {
+                      "attachmentId": {
+                        "anyOf": [
+                          {
+                            "type": "string",
+                            "description": "Gmail attachment ID, or null when bytes are stored directly in the message part."
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ],
+                        "description": "Gmail attachment ID, or null when bytes are stored directly in the message part."
+                      },
+                      "filename": {
+                        "type": "string",
+                        "description": "Attachment filename; empty for unnamed parts."
+                      },
+                      "mimeType": {
+                        "type": "string",
+                        "description": "Attachment MIME type."
+                      },
+                      "size": {
+                        "type": "integer",
+                        "minimum": 0,
+                        "description": "Attachment size in bytes."
+                      },
+                      "partId": {
+                        "anyOf": [
+                          {
+                            "type": "string",
+                            "description": "Gmail MIME part ID when supplied."
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ],
+                        "description": "Gmail MIME part ID when supplied."
+                      },
+                      "contentId": {
+                        "anyOf": [
+                          {
+                            "type": "string",
+                            "description": "Bare Content-ID without angle brackets, when supplied."
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ],
+                        "description": "Bare Content-ID without angle brackets, when supplied."
+                      },
+                      "disposition": {
+                        "anyOf": [
+                          {
+                            "type": "string",
+                            "enum": [
+                              "inline",
+                              "attachment"
+                            ],
+                            "description": "Content-Disposition when supplied and recognized."
+                          },
+                          {
+                            "type": "null"
+                          }
+                        ],
+                        "description": "Content-Disposition when supplied and recognized."
+                      }
+                    },
+                    "additionalProperties": false,
+                    "required": [
+                      "attachmentId",
+                      "filename",
+                      "mimeType",
+                      "size",
+                      "partId",
+                      "contentId",
+                      "disposition"
+                    ],
+                    "description": "Attachment or inline resource metadata from a Gmail MIME part."
                   },
-                  "description": "Message attachments."
+                  "description": "Message attachments and inline resources, including unnamed CID parts."
                 },
                 "raw": {
                   "type": "string",
@@ -4026,7 +5570,7 @@
       "id": "gmail.update_draft",
       "service": "gmail",
       "name": "update_draft",
-      "description": "Update an existing Gmail draft in place.",
+      "description": "Update a Gmail draft while preserving omitted fields, attachments, CID inline images, and reply headers. Supply replyToMessageId or a different threadId to rebuild the reply association; this additionally requires mailbox read access. A reply draft's subject must match its reply target, ignoring Re: prefixes. Omit body to preserve existing MIME body alternatives; supply body to replace them with one text or HTML body. Omit attachments to preserve them, supply a list to replace all attachments and inline images, or [] to remove them. The draft ID stays stable, but the message ID changes on replacement.",
       "operationType": "write",
       "requiredScopes": [
         "https://www.googleapis.com/auth/gmail.compose"
@@ -4089,15 +5633,108 @@
           },
           "body": {
             "type": "string",
-            "description": "Email body content."
+            "description": "Replacement body. Omit to preserve all existing text and HTML alternatives; an empty string clears the body."
           },
           "messageBody": {
             "type": "string",
-            "description": "Reply or draft body content."
+            "description": "Alias for the replacement body. Omit both body fields to preserve existing MIME body alternatives."
           },
           "isHtml": {
             "type": "boolean",
-            "description": "Whether the body is HTML."
+            "description": "Whether the replacement body is HTML. Omit to inherit the existing body type (HTML when an HTML alternative exists). Set false for plain text or true for HTML. Requires body or messageBody."
+          },
+          "attachments": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "filename": {
+                  "type": "string",
+                  "description": "Attachment filename. Omit for an unnamed Base64 attachment; defaults to the transit file name."
+                },
+                "mimeType": {
+                  "type": "string",
+                  "description": "Attachment MIME type as type/subtype without parameters. Defaults to the transit file MIME type or application/octet-stream."
+                },
+                "contentBase64": {
+                  "type": "string",
+                  "description": "Standard Base64 file content. An empty string represents a zero-byte file. Supply exactly one of contentBase64 or file."
+                },
+                "file": {
+                  "type": "object",
+                  "properties": {
+                    "fileId": {
+                      "type": "string",
+                      "minLength": 1,
+                      "description": "The transit file identifier returned by POST /api/files."
+                    },
+                    "name": {
+                      "type": "string",
+                      "minLength": 1,
+                      "description": "Optional filename override to send to the provider."
+                    },
+                    "mimeType": {
+                      "type": "string",
+                      "minLength": 1,
+                      "description": "Optional MIME type override to send to the provider."
+                    }
+                  },
+                  "additionalProperties": false,
+                  "required": [
+                    "fileId"
+                  ],
+                  "description": "An uploaded transit file. Supply exactly one of file or contentBase64."
+                },
+                "contentId": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "Bare Content-ID without cid: or angle brackets. Reference it in HTML as cid:<contentId>."
+                },
+                "disposition": {
+                  "type": "string",
+                  "enum": [
+                    "inline",
+                    "attachment"
+                  ],
+                  "description": "Defaults to inline when contentId is present, otherwise attachment. Inline attachments require contentId."
+                }
+              },
+              "additionalProperties": false,
+              "description": "An email attachment or CID inline image.",
+              "oneOf": [
+                {
+                  "required": [
+                    "contentBase64"
+                  ]
+                },
+                {
+                  "required": [
+                    "file"
+                  ]
+                }
+              ],
+              "allOf": [
+                {
+                  "if": {
+                    "properties": {
+                      "disposition": {
+                        "const": "inline"
+                      }
+                    },
+                    "required": [
+                      "disposition"
+                    ]
+                  },
+                  "then": {
+                    "required": [
+                      "contentId"
+                    ]
+                  }
+                }
+              ]
+            },
+            "description": "Omit to preserve all attachments and CID inline images. A supplied list replaces all of them; [] clears all attachments and inline images.",
+            "maxItems": 100
           },
           "fromEmail": {
             "type": "string",
@@ -4107,6 +5744,11 @@
             "type": "string",
             "minLength": 1,
             "description": "Gmail thread ID."
+          },
+          "replyToMessageId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Gmail message ID to reply to. Requires mailbox read access. If threadId is also supplied, it must match this message's thread."
           }
         },
         "additionalProperties": false,
@@ -4420,5 +6062,156 @@
         "description": "Gmail API object."
       }
     }
+  ],
+  "triggers": [
+    {
+      "configInputs": [
+        {
+          "handle": "includeDrafts",
+          "jsonSchema": {
+            "type": "boolean"
+          },
+          "nullable": false,
+          "value": false,
+          "description": "Also trigger on draft messages."
+        },
+        {
+          "handle": "includeSpamAndTrash",
+          "jsonSchema": {
+            "type": "boolean"
+          },
+          "nullable": false,
+          "value": false,
+          "description": "Also trigger on messages in SPAM and TRASH."
+        },
+        {
+          "handle": "labelNamesOrIds",
+          "jsonSchema": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "nullable": false,
+          "description": "Only trigger on messages carrying all of these labels, referenced by name or ID.",
+          "value": []
+        },
+        {
+          "handle": "maxMessagesPerPoll",
+          "jsonSchema": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100
+          },
+          "nullable": false,
+          "value": 25
+        },
+        {
+          "handle": "readStatus",
+          "jsonSchema": {
+            "type": "string",
+            "enum": [
+              "Read",
+              "Unread",
+              "All"
+            ]
+          },
+          "nullable": false,
+          "value": "All"
+        },
+        {
+          "handle": "search",
+          "jsonSchema": {
+            "type": "string"
+          },
+          "nullable": false,
+          "description": "Gmail search-syntax query the message must match.",
+          "value": ""
+        },
+        {
+          "handle": "sender",
+          "jsonSchema": {
+            "type": "string"
+          },
+          "nullable": false,
+          "description": "Only trigger on messages whose sender matches this address or name.",
+          "value": ""
+        }
+      ],
+      "definitionVersion": 2,
+      "description": "Polls the Gmail mailbox and triggers when a new message is received.",
+      "displayName": "New Message Received",
+      "key": "gmail.on_message_received",
+      "name": "on_message_received",
+      "outputs": [
+        {
+          "handle": "events",
+          "jsonSchema": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "historyId": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "labelIds": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "messageId": {
+                  "type": "string"
+                },
+                "messageTimestamp": {
+                  "type": "string"
+                },
+                "sender": {
+                  "type": "string"
+                },
+                "subject": {
+                  "type": "string"
+                },
+                "threadId": {
+                  "type": "string"
+                },
+                "to": {
+                  "type": "string"
+                }
+              },
+              "additionalProperties": false,
+              "required": [
+                "messageId",
+                "threadId",
+                "historyId",
+                "labelIds",
+                "subject",
+                "sender",
+                "to",
+                "messageTimestamp"
+              ]
+            }
+          },
+          "nullable": false
+        }
+      ],
+      "provider": "gmail",
+      "type": "poll"
+    }
+  ],
+  "triggerPermissions": [
+    {
+      "id": "gmail.on_message_received",
+      "name": "New Message Received",
+      "description": "Reads mailbox history, labels and message headers to detect new messages matching the configured filters. Does not read attachments or change messages.",
+      "providerPermissions": [
+        "https://www.googleapis.com/auth/gmail.readonly"
+      ],
+      "instructions": "Authorize read access to the mailbox."
+    }
   ]
 }