@mindstudio-ai/agent 0.0.20 → 0.1.1

package/dist/index.js

@@ -191,6 +191,9 @@ function applyStepMethods(AgentClass) {
   proto.createDataSource = function(step, options) {
     return this.executeStep("createDataSource", step, options);
   };
+  proto.createGmailDraft = function(step, options) {
+    return this.executeStep("createGmailDraft", step, options);
+  };
   proto.createGoogleCalendarEvent = function(step, options) {
     return this.executeStep("createGoogleCalendarEvent", step, options);
   };
@@ -293,12 +296,18 @@ function applyStepMethods(AgentClass) {
   proto.generateVideo = function(step, options) {
     return this.executeStep("generateVideo", step, options);
   };
+  proto.getGmailAttachments = function(step, options) {
+    return this.executeStep("getGmailAttachments", step, options);
+  };
   proto.getGmailDraft = function(step, options) {
     return this.executeStep("getGmailDraft", step, options);
   };
   proto.getGmailEmail = function(step, options) {
     return this.executeStep("getGmailEmail", step, options);
   };
+  proto.getGmailUnreadCount = function(step, options) {
+    return this.executeStep("getGmailUnreadCount", step, options);
+  };
   proto.getGoogleCalendarEvent = function(step, options) {
     return this.executeStep("getGoogleCalendarEvent", step, options);
   };
@@ -356,12 +365,18 @@ function applyStepMethods(AgentClass) {
   proto.listGmailDrafts = function(step, options) {
     return this.executeStep("listGmailDrafts", step, options);
   };
+  proto.listGmailLabels = function(step, options) {
+    return this.executeStep("listGmailLabels", step, options);
+  };
   proto.listGoogleCalendarEvents = function(step, options) {
     return this.executeStep("listGoogleCalendarEvents", step, options);
   };
   proto.listGoogleDriveFiles = function(step, options) {
     return this.executeStep("listGoogleDriveFiles", step, options);
   };
+  proto.listRecentGmailEmails = function(step, options) {
+    return this.executeStep("listRecentGmailEmails", step, options);
+  };
   proto.logic = function(step, options) {
     return this.executeStep("logic", step, options);
   };
@@ -422,6 +437,9 @@ function applyStepMethods(AgentClass) {
   proto.resizeVideo = function(step, options) {
     return this.executeStep("resizeVideo", step, options);
   };
+  proto.runFromConnectorRegistry = function(step, options) {
+    return this.executeStep("runFromConnectorRegistry", step, options);
+  };
   proto.runPackagedWorkflow = function(step, options) {
     return this.executeStep("runPackagedWorkflow", step, options);
   };
@@ -464,6 +482,9 @@ function applyStepMethods(AgentClass) {
   proto.scrapeXProfile = function(step, options) {
     return this.executeStep("scrapeXProfile", step, options);
   };
+  proto.searchGmailEmails = function(step, options) {
+    return this.executeStep("searchGmailEmails", step, options);
+  };
   proto.searchGoogle = function(step, options) {
     return this.executeStep("searchGoogle", step, options);
   };
@@ -497,9 +518,18 @@ function applyStepMethods(AgentClass) {
   proto.sendEmail = function(step, options) {
     return this.executeStep("sendEmail", step, options);
   };
+  proto.sendGmailDraft = function(step, options) {
+    return this.executeStep("sendGmailDraft", step, options);
+  };
+  proto.sendGmailMessage = function(step, options) {
+    return this.executeStep("sendGmailMessage", step, options);
+  };
   proto.sendSMS = function(step, options) {
     return this.executeStep("sendSMS", step, options);
   };
+  proto.setGmailReadStatus = function(step, options) {
+    return this.executeStep("setGmailReadStatus", step, options);
+  };
   proto.setRunTitle = function(step, options) {
     return this.executeStep("setRunTitle", step, options);
   };
@@ -539,6 +569,9 @@ function applyStepMethods(AgentClass) {
   proto.trimMedia = function(step, options) {
     return this.executeStep("trimMedia", step, options);
   };
+  proto.updateGmailLabels = function(step, options) {
+    return this.executeStep("updateGmailLabels", step, options);
+  };
   proto.updateGoogleCalendarEvent = function(step, options) {
     return this.executeStep("updateGoogleCalendarEvent", step, options);
   };
@@ -586,12 +619,27 @@ function applyHelperMethods(AgentClass) {
   proto.listModelsByType = function(modelType) {
     return this._request("GET", `/helpers/models/${modelType}`).then((r) => r.data);
   };
+  proto.listModelsSummary = function() {
+    return this._request("GET", "/helpers/models-summary").then((r) => r.data);
+  };
+  proto.listModelsSummaryByType = function(modelType) {
+    return this._request("GET", `/helpers/models-summary/${modelType}`).then((r) => r.data);
+  };
   proto.listConnectors = function() {
     return this._request("GET", "/helpers/connectors").then((r) => r.data);
   };
   proto.getConnector = function(serviceId) {
     return this._request("GET", `/helpers/connectors/${serviceId}`).then((r) => r.data);
   };
+  proto.getConnectorAction = function(serviceId, actionId) {
+    return this._request("GET", `/helpers/connectors/${serviceId}/${actionId}`).then((r) => r.data);
+  };
+  proto.listConnections = function() {
+    return this._request("GET", "/helpers/connections").then((r) => r.data);
+  };
+  proto.estimateStepCost = function(stepType, step, options) {
+    return this._request("POST", "/helpers/step-cost-estimate", { step: { type: stepType, ...step }, ...options }).then((r) => r.data);
+  };
 }
 
 // src/client.ts
@@ -785,6 +833,7 @@ var monacoSnippets = {
   "codaGetTableRows": { fields: [["docId", "string"], ["tableId", "string"]], outputKeys: ["rows"] },
   "convertPdfToImages": { fields: [["pdfUrl", "string"]], outputKeys: ["imageUrls"] },
   "createDataSource": { fields: [["name", "string"]], outputKeys: [] },
+  "createGmailDraft": { fields: [["to", "string"], ["subject", "string"], ["message", "string"], ["messageType", ["plain", "html", "markdown"]]], outputKeys: ["draftId"] },
   "createGoogleCalendarEvent": { fields: [["summary", "string"], ["startDateTime", "string"], ["endDateTime", "string"]], outputKeys: ["eventId", "htmlLink"] },
   "createGoogleDoc": { fields: [["title", "string"], ["text", "string"], ["textType", ["plain", "html", "markdown"]]], outputKeys: ["documentUrl"] },
   "createGoogleSheet": { fields: [["title", "string"], ["text", "string"]], outputKeys: ["spreadsheetUrl"] },
@@ -821,8 +870,10 @@ var monacoSnippets = {
   "generateStaticVideoFromImage": { fields: [["imageUrl", "string"], ["duration", "string"]], outputKeys: ["videoUrl"] },
   "generateText": { fields: [["message", "string"]], outputKeys: ["content"] },
   "generateVideo": { fields: [["prompt", "string"]], outputKeys: ["videoUrl"] },
+  "getGmailAttachments": { fields: [["messageId", "string"]], outputKeys: [] },
   "getGmailDraft": { fields: [["draftId", "string"]], outputKeys: ["draftId", "messageId", "subject", "to", "from", "body"] },
   "getGmailEmail": { fields: [["messageId", "string"]], outputKeys: ["messageId", "subject", "from", "to", "date", "body", "labels"] },
+  "getGmailUnreadCount": { fields: [], outputKeys: [] },
   "getGoogleCalendarEvent": { fields: [["eventId", "string"], ["exportType", ["json", "text"]]], outputKeys: ["event"] },
   "getGoogleDriveFile": { fields: [["fileId", "string"]], outputKeys: ["url", "name", "mimeType", "size"] },
   "getGoogleSheetInfo": { fields: [["documentId", "string"]], outputKeys: ["title", "sheets"] },
@@ -842,8 +893,10 @@ var monacoSnippets = {
   "insertVideoClips": { fields: [["baseVideoUrl", "string"], ["overlayVideos", "array"]], outputKeys: ["videoUrl"] },
   "listDataSources": { fields: [], outputKeys: [] },
   "listGmailDrafts": { fields: [["exportType", ["json", "text"]]], outputKeys: ["drafts"] },
+  "listGmailLabels": { fields: [], outputKeys: [] },
   "listGoogleCalendarEvents": { fields: [["limit", "number"], ["exportType", ["json", "text"]]], outputKeys: ["events"] },
   "listGoogleDriveFiles": { fields: [["exportType", ["json", "text"]]], outputKeys: ["files"] },
+  "listRecentGmailEmails": { fields: [["exportType", ["json", "text"]], ["limit", "string"]], outputKeys: [] },
   "logic": { fields: [["context", "string"], ["cases", "array"]], outputKeys: ["selectedCase"] },
   "makeDotComRunScenario": { fields: [["webhookUrl", "string"], ["input", "object"]], outputKeys: ["data"] },
   "mergeAudio": { fields: [["mp3Urls", "array"]], outputKeys: ["audioUrl"] },
@@ -864,6 +917,7 @@ var monacoSnippets = {
   "removeBackgroundFromImage": { fields: [["imageUrl", "string"]], outputKeys: ["imageUrl"] },
   "replyToGmailEmail": { fields: [["messageId", "string"], ["message", "string"], ["messageType", ["plain", "html", "markdown"]]], outputKeys: ["messageId"] },
   "resizeVideo": { fields: [["videoUrl", "string"], ["mode", ["fit", "exact"]]], outputKeys: ["videoUrl"] },
+  "runFromConnectorRegistry": { fields: [["actionId", "string"], ["displayName", "string"], ["icon", "string"], ["configurationValues", "object"]], outputKeys: ["data"] },
   "runPackagedWorkflow": { fields: [["appId", "string"], ["workflowId", "string"], ["inputVariables", "object"], ["outputVariables", "object"], ["name", "string"]], outputKeys: ["data"] },
   "scrapeFacebookPage": { fields: [["pageUrl", "string"]], outputKeys: ["data"] },
   "scrapeFacebookPosts": { fields: [["pageUrl", "string"]], outputKeys: ["data"] },
@@ -878,6 +932,7 @@ var monacoSnippets = {
   "scrapeUrl": { fields: [["url", "string"]], outputKeys: ["content"] },
   "scrapeXPost": { fields: [["url", "string"]], outputKeys: ["post"] },
   "scrapeXProfile": { fields: [["url", "string"]], outputKeys: ["profile"] },
+  "searchGmailEmails": { fields: [["query", "string"], ["exportType", ["json", "text"]], ["limit", "string"]], outputKeys: ["emails"] },
   "searchGoogle": { fields: [["query", "string"], ["exportType", ["text", "json"]]], outputKeys: ["results"] },
   "searchGoogleCalendarEvents": { fields: [["exportType", ["json", "text"]]], outputKeys: ["events"] },
   "searchGoogleDrive": { fields: [["query", "string"], ["exportType", ["json", "text"]]], outputKeys: ["files"] },
@@ -889,7 +944,10 @@ var monacoSnippets = {
   "searchYoutube": { fields: [["query", "string"], ["limitPages", "string"], ["filter", "string"], ["filterType", "string"]], outputKeys: ["results"] },
   "searchYoutubeTrends": { fields: [["bp", ["now", "music", "gaming", "films"]], ["hl", "string"], ["gl", "string"]], outputKeys: ["trends"] },
   "sendEmail": { fields: [["subject", "string"], ["body", "string"]], outputKeys: ["recipients"] },
+  "sendGmailDraft": { fields: [["draftId", "string"]], outputKeys: [] },
+  "sendGmailMessage": { fields: [["to", "string"], ["subject", "string"], ["message", "string"], ["messageType", ["plain", "html", "markdown"]]], outputKeys: ["messageId"] },
   "sendSMS": { fields: [["body", "string"]], outputKeys: [] },
+  "setGmailReadStatus": { fields: [["messageIds", "string"], ["markAsRead", "boolean"]], outputKeys: [] },
   "setRunTitle": { fields: [["title", "string"]], outputKeys: [] },
   "setVariable": { fields: [["value", "string"]], outputKeys: [] },
   "telegramEditMessage": { fields: [["botToken", "string"], ["chatId", "string"], ["messageId", "string"], ["text", "string"]], outputKeys: [] },
@@ -903,6 +961,7 @@ var monacoSnippets = {
   "textToSpeech": { fields: [["text", "string"]], outputKeys: ["audioUrl"] },
   "transcribeAudio": { fields: [["audioUrl", "string"], ["prompt", "string"]], outputKeys: ["text"] },
   "trimMedia": { fields: [["inputUrl", "string"]], outputKeys: ["mediaUrl"] },
+  "updateGmailLabels": { fields: [["query", "string"], ["messageIds", "string"], ["addLabelIds", "string"], ["removeLabelIds", "string"]], outputKeys: ["updatedMessageIds"] },
   "updateGoogleCalendarEvent": { fields: [["eventId", "string"]], outputKeys: ["eventId", "htmlLink"] },
   "updateGoogleDoc": { fields: [["documentId", "string"], ["text", "string"], ["textType", ["plain", "html", "markdown"]], ["operationType", ["addToTop", "addToBottom", "overwrite"]]], outputKeys: ["documentUrl"] },
   "updateGoogleSheet": { fields: [["text", "string"], ["spreadsheetId", "string"], ["range", "string"], ["operationType", ["addToBottom", "overwrite", "range"]]], outputKeys: ["spreadsheetUrl"] },
@@ -1042,6 +1101,15 @@ var stepMetadata = {
     inputSchema: { "type": "object", "properties": { "name": { "type": "string", "description": "Name for the new data source (supports variable interpolation)" } }, "required": ["name"] },
     outputSchema: { "description": "This step does not produce output data." }
   },
+  "createGmailDraft": {
+    stepType: "createGmailDraft",
+    description: "Create a draft email in the connected Gmail account.",
+    usageNotes: `- Requires a Google OAuth connection with Gmail compose scope.
+- The draft appears in the user's Gmail Drafts folder but is not sent.
+- messageType controls the body format: "plain" for plain text, "html" for raw HTML, "markdown" for auto-converted markdown.`,
+    inputSchema: { "type": "object", "properties": { "to": { "type": "string", "description": "Recipient email address(es), comma-separated for multiple" }, "subject": { "type": "string", "description": "Email subject line" }, "message": { "type": "string", "description": "Email body content" }, "connectionId": { "type": "string", "description": "Google OAuth connection ID" }, "messageType": { "enum": ["plain", "html", "markdown"], "type": "string", "description": 'Body format: "plain", "html", or "markdown"' } }, "required": ["to", "subject", "message", "messageType"] },
+    outputSchema: { "type": "object", "properties": { "draftId": { "type": "string", "description": "Gmail draft ID" } }, "required": ["draftId"] }
+  },
   "createGoogleCalendarEvent": {
     stepType: "createGoogleCalendarEvent",
     description: "Create a new event on a Google Calendar.",
@@ -1297,6 +1365,13 @@ var stepMetadata = {
     inputSchema: { "type": "object", "properties": { "prompt": { "type": "string", "description": "Text prompt describing the video to generate" }, "skipAssetCreation": { "type": "boolean", "description": "If true, the video will not appear in the user's asset history" }, "videoModelOverride": { "type": "object", "properties": { "model": { "type": "string", "description": "Video generation model identifier" }, "config": { "type": "object", "description": "Additional model-specific configuration" } }, "required": ["model"], "description": "Optional model configuration override. Uses the workflow's default video model if not specified" }, "generateVariants": { "type": "boolean", "description": "Whether to generate multiple video variants in parallel" }, "numVariants": { "type": "number", "description": "Number of variants to generate (max 10)" }, "addWatermark": { "type": "boolean", "description": "Whether to add a MindStudio watermark to the generated video" } }, "required": ["prompt"] },
     outputSchema: { "type": "object", "properties": { "videoUrl": { "anyOf": [{ "type": "string" }, { "type": "array", "items": { "type": "string" } }] } }, "required": ["videoUrl"] }
   },
+  "getGmailAttachments": {
+    stepType: "getGmailAttachments",
+    description: "Download attachments from a Gmail email and re-host them on CDN.",
+    usageNotes: "- Requires a Google OAuth connection with Gmail readonly scope.\n- Attachments are uploaded to CDN and returned as URLs.\n- Attachments larger than 25MB are skipped.\n- Use the message ID from Search Gmail Emails, List Recent Gmail Emails, or Get Gmail Email steps.",
+    inputSchema: { "type": "object", "properties": { "messageId": { "type": "string", "description": "Gmail message ID" }, "connectionId": { "type": "string", "description": "Google OAuth connection ID" } }, "required": ["messageId"] },
+    outputSchema: { "description": "This step does not produce output data." }
+  },
   "getGmailDraft": {
     stepType: "getGmailDraft",
     description: "Retrieve a specific draft from Gmail by draft ID.",
@@ -1311,6 +1386,13 @@ var stepMetadata = {
     inputSchema: { "type": "object", "properties": { "messageId": { "type": "string", "description": "Gmail message ID to retrieve" }, "connectionId": { "type": "string", "description": "Google OAuth connection ID" } }, "required": ["messageId"] },
     outputSchema: { "type": "object", "properties": { "messageId": { "type": "string", "description": "Gmail message ID" }, "subject": { "type": "string", "description": "Email subject" }, "from": { "type": "string", "description": "Sender email" }, "to": { "type": "string", "description": "Recipient email" }, "date": { "type": "string", "description": "Email date" }, "body": { "type": "string", "description": "Email body content" }, "labels": { "type": "string", "description": "Comma-separated label IDs" } }, "required": ["messageId", "subject", "from", "to", "date", "body", "labels"] }
   },
+  "getGmailUnreadCount": {
+    stepType: "getGmailUnreadCount",
+    description: "Get the number of unread emails in the connected Gmail inbox.",
+    usageNotes: "- Requires a Google OAuth connection with Gmail readonly scope.\n- Returns the unread message count for the inbox label.\n- This is a lightweight call that does not fetch any email content.",
+    inputSchema: { "type": "object", "properties": { "connectionId": { "type": "string", "description": "Google OAuth connection ID" } } },
+    outputSchema: { "description": "This step does not produce output data." }
+  },
   "getGoogleCalendarEvent": {
     stepType: "getGoogleCalendarEvent",
     description: "Retrieve a specific event from a Google Calendar by event ID.",
@@ -1444,6 +1526,13 @@ var stepMetadata = {
     inputSchema: { "type": "object", "properties": { "connectionId": { "type": "string", "description": "Google OAuth connection ID" }, "limit": { "type": "string", "description": "Max drafts to return (default: 10, max: 50)" }, "exportType": { "enum": ["json", "text"], "type": "string", "description": 'Format for the variable output: "json" or "text"' } }, "required": ["exportType"] },
     outputSchema: { "type": "object", "properties": { "drafts": { "type": "array", "items": { "type": "object", "properties": { "draftId": { "type": "string", "description": "Gmail draft ID" }, "messageId": { "type": "string", "description": "Gmail message ID" }, "subject": { "type": "string", "description": "Email subject" }, "to": { "type": "string", "description": "Recipient email" }, "snippet": { "type": "string", "description": "Short preview text" } }, "required": ["draftId", "messageId", "subject", "to", "snippet"] }, "description": "List of draft summaries" } }, "required": ["drafts"] }
   },
+  "listGmailLabels": {
+    stepType: "listGmailLabels",
+    description: "List all labels in the connected Gmail account. Use these label IDs or names with the Update Gmail Labels step.",
+    usageNotes: '- Requires a Google OAuth connection with Gmail readonly scope.\n- Returns both system labels (INBOX, SENT, TRASH, etc.) and user-created labels.\n- Label type is "system" for built-in labels or "user" for custom labels.',
+    inputSchema: { "type": "object", "properties": { "connectionId": { "type": "string", "description": "Google OAuth connection ID" } } },
+    outputSchema: { "description": "This step does not produce output data." }
+  },
   "listGoogleCalendarEvents": {
     stepType: "listGoogleCalendarEvents",
     description: "List upcoming events from a Google Calendar, ordered by start time.",
@@ -1458,6 +1547,13 @@ var stepMetadata = {
     inputSchema: { "type": "object", "properties": { "folderId": { "type": "string", "description": "Google Drive folder ID (defaults to root)" }, "limit": { "type": "number", "description": "Max files to return (default: 20)" }, "connectionId": { "type": "string", "description": "Google OAuth connection ID" }, "exportType": { "enum": ["json", "text"], "type": "string", "description": 'Format for the variable output: "json" or "text"' } }, "required": ["exportType"] },
     outputSchema: { "type": "object", "properties": { "files": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "mimeType": { "type": "string" }, "size": { "type": "string" }, "webViewLink": { "type": "string" }, "createdTime": { "type": "string" }, "modifiedTime": { "type": "string" } }, "required": ["id", "name", "mimeType", "size", "webViewLink", "createdTime", "modifiedTime"] }, "description": "List of files in the folder" } }, "required": ["files"] }
   },
+  "listRecentGmailEmails": {
+    stepType: "listRecentGmailEmails",
+    description: "List recent emails from the connected Gmail inbox.",
+    usageNotes: '- Requires a Google OAuth connection with Gmail readonly scope.\n- Returns up to 100 emails (default 5), ordered by most recent first.\n- Functionally equivalent to Search Gmail Emails with an "in:inbox" query.',
+    inputSchema: { "type": "object", "properties": { "connectionId": { "type": "string", "description": "Google OAuth connection ID" }, "exportType": { "enum": ["json", "text"], "type": "string", "description": 'Format for the variable output: "json" or "text"' }, "limit": { "type": "string", "description": "Maximum number of emails to return (1-100, default: 5)" } }, "required": ["exportType", "limit"] },
+    outputSchema: { "description": "This step does not produce output data." }
+  },
   "logic": {
     stepType: "logic",
     description: "Route execution to different branches based on AI evaluation, comparison operators, or workflow jumps.",
@@ -1602,6 +1698,13 @@ var stepMetadata = {
     inputSchema: { "type": "object", "properties": { "videoUrl": { "type": "string", "description": "URL of the source video to resize" }, "mode": { "enum": ["fit", "exact"], "type": "string", "description": "Resize mode: 'fit' scales within max dimensions, 'exact' forces exact dimensions" }, "maxWidth": { "type": "number", "description": "Maximum width in pixels (used with 'fit' mode)" }, "maxHeight": { "type": "number", "description": "Maximum height in pixels (used with 'fit' mode)" }, "width": { "type": "number", "description": "Exact width in pixels (used with 'exact' mode)" }, "height": { "type": "number", "description": "Exact height in pixels (used with 'exact' mode)" }, "strategy": { "enum": ["pad", "crop"], "type": "string", "description": "Strategy for handling aspect ratio mismatch in 'exact' mode" }, "skipAssetCreation": { "type": "boolean", "description": "When true, the result will not appear in the user's asset history. Useful for intermediate compositing steps." } }, "required": ["videoUrl", "mode"] },
     outputSchema: { "type": "object", "properties": { "videoUrl": { "type": "string", "description": "URL of the resized video" } }, "required": ["videoUrl"] }
   },
+  "runFromConnectorRegistry": {
+    stepType: "runFromConnectorRegistry",
+    description: "Run a raw API connector to a third-party service",
+    usageNotes: '- Use the /developer/v2/helpers/connectors endpoint to list available services and actions.\n- Use /developer/v2/helpers/connectors/{serviceId}/{actionId} to get the full input configuration for an action.\n- Use /developer/v2/helpers/connections to list your available OAuth connections.\n- The actionId format is "serviceId/actionId" (e.g., "slack/send-message").\n- Pass a __connectionId to authenticate the request with a specific OAuth connection, otherwise the default will be used (if configured).',
+    inputSchema: { "type": "object", "properties": { "actionId": { "type": "string", "description": "The connector action identifier in the format serviceId/actionId" }, "displayName": { "type": "string", "description": "Human-readable name of the connector action" }, "icon": { "type": "string", "description": "Icon URL for the connector" }, "configurationValues": { "type": "object", "description": "Key-value configuration parameters for the connector action" }, "__connectionId": { "type": "string", "description": "OAuth connection ID used to authenticate the connector request" } }, "required": ["actionId", "displayName", "icon", "configurationValues"], "description": "Configuration for the connector registry step" },
+    outputSchema: { "type": "object", "properties": { "data": { "type": "object", "description": "Key-value map of output variables set by the connector" } }, "required": ["data"] }
+  },
   "runPackagedWorkflow": {
     stepType: "runPackagedWorkflow",
     description: 'Run a packaged workflow ("custom block")',
@@ -1702,6 +1805,13 @@ var stepMetadata = {
     inputSchema: { "type": "object", "properties": { "url": { "type": "string", "description": "Full URL or username for the X profile (e.g. https://x.com/elonmusk)" } }, "required": ["url"] },
     outputSchema: { "type": "object", "properties": { "profile": { "type": "object", "properties": { "text": { "type": "string", "description": "Markdown/plain-text content of the scraped page" }, "html": { "type": "string", "description": "Raw HTML content of the scraped page" }, "json": { "type": "object", "description": "Structured data extracted from the page" }, "screenshotUrl": { "type": "string", "description": "Screenshot URL of the page (if requested)" }, "metadata": { "type": "object", "properties": { "title": { "type": "string", "description": "Page title" }, "description": { "type": "string", "description": "Page meta description" }, "url": { "type": "string", "description": "Canonical URL" }, "image": { "type": "string", "description": "Open Graph image URL" } }, "required": ["title", "description", "url", "image"], "description": "Page metadata (Open Graph / meta tags)" } }, "required": ["text", "html"], "description": "Scraped profile data including text, HTML, and optional structured JSON" } }, "required": ["profile"] }
   },
+  "searchGmailEmails": {
+    stepType: "searchGmailEmails",
+    description: "Search for emails in the connected Gmail account using a Gmail search query. To list recent inbox emails, pass an empty query string.",
+    usageNotes: '- Requires a Google OAuth connection with Gmail readonly scope.\n- Uses Gmail search syntax (e.g. "from:user@example.com", "subject:invoice", "is:unread").\n- To list recent inbox emails, use an empty query string or "in:inbox".\n- Returns up to 100 emails (default 5). The variable receives text or JSON depending on exportType.\n- The direct execution output always returns structured email objects.',
+    inputSchema: { "type": "object", "properties": { "query": { "type": "string", "description": 'Gmail search query (e.g. "from:user@example.com", "subject:invoice", "is:unread")' }, "connectionId": { "type": "string", "description": "Google OAuth connection ID" }, "exportType": { "enum": ["json", "text"], "type": "string", "description": 'Format for the variable output: "json" or "text"' }, "limit": { "type": "string", "description": "Maximum number of emails to return (1-10, default: 5)" } }, "required": ["query", "exportType", "limit"] },
+    outputSchema: { "type": "object", "properties": { "emails": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "Gmail message ID" }, "subject": { "type": "string", "description": "Email subject line" }, "from": { "type": "string", "description": "Sender email address" }, "to": { "type": "string", "description": "Recipient email address" }, "date": { "type": "string", "description": "Email date" }, "plainBody": { "type": "string", "description": "Plain text body content" }, "htmlBody": { "type": "string", "description": "HTML body content (if available)" }, "labels": { "type": "string", "description": "Comma-separated label IDs applied to the email" } }, "required": ["id", "subject", "from", "to", "date", "plainBody", "htmlBody", "labels"] }, "description": "List of matching email messages" } }, "required": ["emails"] }
+  },
   "searchGoogle": {
     stepType: "searchGoogle",
     description: "Search the web using Google and return structured results.",
@@ -1779,6 +1889,20 @@ var stepMetadata = {
     inputSchema: { "type": "object", "properties": { "subject": { "type": "string", "description": "Email subject line" }, "body": { "type": "string", "description": "Email body content (plain text, markdown, HTML, or a CDN URL to an HTML file)" }, "connectionId": { "type": "string", "description": "OAuth connection ID(s) for the recipient(s), comma-separated for multiple" }, "generateHtml": { "type": "boolean", "description": "When true, auto-convert the body text into a styled HTML email using AI" }, "generateHtmlInstructions": { "type": "string", "description": "Natural language instructions for the HTML generation style" }, "generateHtmlModelOverride": { "type": "object", "properties": { "model": { "type": "string", "description": 'Model identifier (e.g. "gpt-4", "claude-3-opus")' }, "temperature": { "type": "number", "description": "Sampling temperature for the model (0-2)" }, "maxResponseTokens": { "type": "number", "description": "Maximum number of tokens in the model's response" }, "ignorePreamble": { "type": "boolean", "description": "Whether to skip the system preamble/instructions" }, "userMessagePreprocessor": { "type": "object", "properties": { "dataSource": { "type": "string", "description": "Data source identifier for the preprocessor" }, "messageTemplate": { "type": "string", "description": "Template string applied to user messages before sending to the model" }, "maxResults": { "type": "number", "description": "Maximum number of results to include from the data source" }, "enabled": { "type": "boolean", "description": "Whether the preprocessor is active" }, "shouldInherit": { "type": "boolean", "description": "Whether child steps should inherit this preprocessor configuration" } }, "description": "Preprocessor applied to user messages before sending to the model" }, "preamble": { "type": "string", "description": "System preamble/instructions for the model" }, "multiModelEnabled": { "type": "boolean", "description": "Whether multi-model candidate generation is enabled" }, "editResponseEnabled": { "type": "boolean", "description": "Whether the user can edit the model's response" }, "config": { "type": "object", "description": "Additional model-specific configuration" } }, "required": ["model", "temperature", "maxResponseTokens"], "description": "Model settings override for HTML generation" }, "attachments": { "type": "array", "items": { "type": "string" }, "description": "URLs of files to attach to the email" } }, "required": ["subject", "body"] },
     outputSchema: { "type": "object", "properties": { "recipients": { "type": "array", "items": { "type": "string" }, "description": "Email addresses the message was sent to" } }, "required": ["recipients"] }
   },
+  "sendGmailDraft": {
+    stepType: "sendGmailDraft",
+    description: "Send an existing draft from the connected Gmail account.",
+    usageNotes: "- Requires a Google OAuth connection with Gmail compose scope.\n- The draft is sent and removed from the Drafts folder.\n- Use the draft ID returned by the Create Gmail Draft or List Gmail Drafts steps.",
+    inputSchema: { "type": "object", "properties": { "draftId": { "type": "string", "description": "Gmail draft ID to send" }, "connectionId": { "type": "string", "description": "Google OAuth connection ID" } }, "required": ["draftId"] },
+    outputSchema: { "description": "This step does not produce output data." }
+  },
+  "sendGmailMessage": {
+    stepType: "sendGmailMessage",
+    description: "Send an email from the connected Gmail account.",
+    usageNotes: '- Requires a Google OAuth connection with Gmail compose scope.\n- messageType controls the body format: "plain" for plain text, "html" for raw HTML, "markdown" for auto-converted markdown.',
+    inputSchema: { "type": "object", "properties": { "to": { "type": "string", "description": "Recipient email address(es), comma-separated for multiple" }, "subject": { "type": "string", "description": "Email subject line" }, "message": { "type": "string", "description": "Email body content" }, "connectionId": { "type": "string", "description": "Google OAuth connection ID" }, "messageType": { "enum": ["plain", "html", "markdown"], "type": "string", "description": 'Body format: "plain", "html", or "markdown"' } }, "required": ["to", "subject", "message", "messageType"] },
+    outputSchema: { "type": "object", "properties": { "messageId": { "type": "string", "description": "Gmail message ID of the sent email" } }, "required": ["messageId"] }
+  },
   "sendSMS": {
     stepType: "sendSMS",
     description: "Send an SMS or MMS message to a phone number configured via OAuth connection.",
@@ -1786,6 +1910,13 @@ var stepMetadata = {
     inputSchema: { "type": "object", "properties": { "body": { "type": "string", "description": "SMS message body text" }, "connectionId": { "type": "string", "description": "OAuth connection ID for the recipient phone number" }, "mediaUrls": { "type": "array", "items": { "type": "string" }, "description": "Optional array of media URLs to send as MMS (up to 10, 5MB each)" } }, "required": ["body"] },
     outputSchema: { "description": "This step does not produce output data." }
   },
+  "setGmailReadStatus": {
+    stepType: "setGmailReadStatus",
+    description: "Mark one or more Gmail emails as read or unread.",
+    usageNotes: "- Requires a Google OAuth connection with Gmail modify scope.\n- Accepts one or more message IDs as a comma-separated string or array.\n- Set markAsRead to true to mark as read, false to mark as unread.",
+    inputSchema: { "type": "object", "properties": { "messageIds": { "type": "string", "description": "Gmail message ID(s), comma-separated" }, "markAsRead": { "type": "boolean", "description": "true = mark as read, false = mark as unread" }, "connectionId": { "type": "string", "description": "Google OAuth connection ID" } }, "required": ["messageIds", "markAsRead"] },
+    outputSchema: { "description": "This step does not produce output data." }
+  },
   "setRunTitle": {
     stepType: "setRunTitle",
     description: "Set the title of the agent run for the user's history",
@@ -1877,6 +2008,13 @@ var stepMetadata = {
     inputSchema: { "type": "object", "properties": { "inputUrl": { "type": "string", "description": "URL of the source audio or video file to trim" }, "start": { "type": ["number", "string"] }, "duration": { "type": ["string", "number"] }, "skipAssetCreation": { "type": "boolean", "description": "When true, the result will not appear in the user's asset history. Useful for intermediate compositing steps." } }, "required": ["inputUrl"] },
     outputSchema: { "type": "object", "properties": { "mediaUrl": { "type": "string", "description": "URL of the trimmed media file" } }, "required": ["mediaUrl"] }
   },
+  "updateGmailLabels": {
+    stepType: "updateGmailLabels",
+    description: "Add or remove labels on Gmail messages, identified by message IDs or a search query.",
+    usageNotes: "- Requires a Google OAuth connection with Gmail modify scope.\n- Provide either a query (Gmail search syntax) or explicit messageIds to target messages.\n- Label IDs can be label names or Gmail label IDs \u2014 names are resolved automatically.",
+    inputSchema: { "type": "object", "properties": { "query": { "type": "string", "description": "Gmail search query to find messages (alternative to messageIds)" }, "connectionId": { "type": "string", "description": "Google OAuth connection ID" }, "messageIds": { "type": "string", "description": "Comma-separated message IDs to target (alternative to query)" }, "addLabelIds": { "type": "string", "description": "Comma-separated label names or IDs to add" }, "removeLabelIds": { "type": "string", "description": "Comma-separated label names or IDs to remove" } }, "required": ["query", "messageIds", "addLabelIds", "removeLabelIds"] },
+    outputSchema: { "type": "object", "properties": { "updatedMessageIds": { "type": "array", "items": { "type": "string" }, "description": "Gmail message IDs that were updated" } }, "required": ["updatedMessageIds"] }
+  },
   "updateGoogleCalendarEvent": {
     stepType: "updateGoogleCalendarEvent",
     description: "Update an existing event on a Google Calendar. Only specified fields are changed.",