@mindstudio-ai/agent 0.0.20 → 0.1.1

package/dist/cli.js

@@ -138,6 +138,15 @@ var init_metadata = __esm({
         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.",
@@ -393,6 +402,13 @@ var init_metadata = __esm({
         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.",
@@ -407,6 +423,13 @@ var init_metadata = __esm({
         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.",
@@ -540,6 +563,13 @@ var init_metadata = __esm({
         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.",
@@ -554,6 +584,13 @@ var init_metadata = __esm({
         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.",
@@ -698,6 +735,13 @@ var init_metadata = __esm({
         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")',
@@ -798,6 +842,13 @@ var init_metadata = __esm({
         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.",
@@ -875,6 +926,20 @@ var init_metadata = __esm({
         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.",
@@ -882,6 +947,13 @@ var init_metadata = __esm({
         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",
@@ -973,6 +1045,13 @@ var init_metadata = __esm({
         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.",
@@ -1303,6 +1382,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);
   };
@@ -1405,12 +1487,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);
   };
@@ -1468,12 +1556,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);
   };
@@ -1534,6 +1628,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);
   };
@@ -1576,6 +1673,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);
   };
@@ -1609,9 +1709,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);
   };
@@ -1651,6 +1760,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);
   };
@@ -1707,12 +1819,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);
+  };
 }
 var init_helpers = __esm({
   "src/generated/helpers.ts"() {
@@ -1966,7 +2093,7 @@ async function startMcpServer(options) {
           capabilities: { tools: {} },
           serverInfo: {
             name: "mindstudio-agent",
-            version: "0.0.20"
+            version: "0.1.1"
           }
         });
         break;
@@ -1980,18 +2107,52 @@ async function startMcpServer(options) {
         const args = params.arguments ?? {};
         try {
           let result;
-          if (toolName === "listModels") {
+          if (toolName === "listSteps") {
+            const meta = await getMetadata();
+            const summary = {};
+            for (const [name, step] of Object.entries(meta)) {
+              summary[name] = step.description;
+            }
+            for (const [name, desc] of Object.entries(
+              HELPER_DESCRIPTIONS
+            )) {
+              summary[name] = desc;
+            }
+            result = summary;
+          } else if (toolName === "listModels") {
             result = await getAgent().listModels();
           } else if (toolName === "listModelsByType") {
             result = await getAgent().listModelsByType(
               args.modelType
             );
+          } else if (toolName === "listModelsSummary") {
+            result = await getAgent().listModelsSummary();
+          } else if (toolName === "listModelsSummaryByType") {
+            result = await getAgent().listModelsSummaryByType(
+              args.modelType
+            );
           } else if (toolName === "listConnectors") {
             result = await getAgent().listConnectors();
           } else if (toolName === "getConnector") {
             result = await getAgent().getConnector(
               args.serviceId
             );
+          } else if (toolName === "getConnectorAction") {
+            result = await getAgent().getConnectorAction(
+              args.serviceId,
+              args.actionId
+            );
+          } else if (toolName === "listConnections") {
+            result = await getAgent().listConnections();
+          } else if (toolName === "estimateStepCost") {
+            result = await getAgent().estimateStepCost(
+              args.stepType,
+              args.step,
+              {
+                appId: args.appId,
+                workflowId: args.workflowId
+              }
+            );
           } else if (toolName === "listAgents") {
             result = await getAgent().listAgents();
           } else if (toolName === "runAgent") {
@@ -2046,13 +2207,31 @@ async function startMcpServer(options) {
     }
   }
 }
-var MCP_PROTOCOL_VERSION, HELPER_TOOLS;
+var MCP_PROTOCOL_VERSION, HELPER_DESCRIPTIONS, HELPER_TOOLS;
 var init_mcp = __esm({
   "src/mcp.ts"() {
     "use strict";
     init_client();
     MCP_PROTOCOL_VERSION = "2024-11-05";
+    HELPER_DESCRIPTIONS = {
+      listModels: "List all available AI models.",
+      listModelsByType: "List AI models filtered by type.",
+      listModelsSummary: "List all AI models (summary: id, name, type, tags).",
+      listModelsSummaryByType: "List AI models (summary) filtered by type.",
+      listConnectors: "List available connector services and their actions.",
+      getConnector: "Get details for a connector service.",
+      getConnectorAction: "Get full configuration for a connector action.",
+      listConnections: "List OAuth connections for the organization.",
+      estimateStepCost: "Estimate the cost of executing a step before running it.",
+      listAgents: "List all pre-built agents in the organization.",
+      runAgent: "Run a pre-built agent and wait for the result."
+    };
     HELPER_TOOLS = [
+      {
+        name: "listSteps",
+        description: "List all available methods with their descriptions. Returns a compact { method: description } map. Use this first to discover what steps and helpers are available, then call a specific method by name.",
+        inputSchema: { type: "object", properties: {} }
+      },
       {
         name: "listModels",
         description: "List all available AI models across all categories.",
@@ -2080,9 +2259,36 @@ var init_mcp = __esm({
           required: ["modelType"]
         }
       },
+      {
+        name: "listModelsSummary",
+        description: "List all available AI models (summary) with only id, name, type, and tags. Suitable for display or consumption inside a model context window.",
+        inputSchema: { type: "object", properties: {} }
+      },
+      {
+        name: "listModelsSummaryByType",
+        description: "List AI models (summary) filtered by type.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            modelType: {
+              type: "string",
+              enum: [
+                "llm_chat",
+                "image_generation",
+                "video_generation",
+                "video_analysis",
+                "text_to_speech",
+                "vision",
+                "transcription"
+              ]
+            }
+          },
+          required: ["modelType"]
+        }
+      },
       {
         name: "listConnectors",
-        description: "List available connector services (Slack, Google, HubSpot, etc.).",
+        description: "List available connector services (Slack, Google, HubSpot, etc.) and their actions.",
         inputSchema: { type: "object", properties: {} }
       },
       {
@@ -2094,6 +2300,56 @@ var init_mcp = __esm({
           required: ["serviceId"]
         }
       },
+      {
+        name: "getConnectorAction",
+        description: "Get the full configuration for a connector action, including all input fields needed to call it via runFromConnectorRegistry.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            serviceId: {
+              type: "string",
+              description: "The connector service ID."
+            },
+            actionId: {
+              type: "string",
+              description: 'The full action ID including service prefix (e.g. "slack/send-message").'
+            }
+          },
+          required: ["serviceId", "actionId"]
+        }
+      },
+      {
+        name: "listConnections",
+        description: "List OAuth connections for the organization. Use the returned connection IDs when calling connector actions.",
+        inputSchema: { type: "object", properties: {} }
+      },
+      {
+        name: "estimateStepCost",
+        description: "Estimate the cost of executing a step before running it. Pass the same step config you would use for execution.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            stepType: {
+              type: "string",
+              description: 'The step type name (e.g. "generateText").'
+            },
+            step: {
+              type: "object",
+              description: "The step input parameters.",
+              additionalProperties: true
+            },
+            appId: {
+              type: "string",
+              description: "Optional app ID for context-specific pricing."
+            },
+            workflowId: {
+              type: "string",
+              description: "Optional workflow ID for context-specific pricing."
+            }
+          },
+          required: ["stepType"]
+        }
+      },
       {
         name: "listAgents",
         description: "List all pre-built agents in the organization along with org metadata.",
@@ -2141,7 +2397,7 @@ Commands:
   whoami                      Show current authentication status
   <method> [json | --flags]   Execute a step method (shorthand for exec)
   exec <method> [json | --flags]   Execute a step method
-  list [--json]               List available methods
+  list [--json] [--summary]   List available methods (--summary for compact JSON)
   info <method>               Show method details (params, types, output)
   agents [--json]             List pre-built agents in your organization
   run <appId> [json | --flags]  Run a pre-built agent and wait for result
@@ -2233,8 +2489,13 @@ async function readStdin() {
 var HELPER_NAMES = /* @__PURE__ */ new Set([
   "listModels",
   "listModelsByType",
+  "listModelsSummary",
+  "listModelsSummaryByType",
   "listConnectors",
-  "getConnector"
+  "getConnector",
+  "getConnectorAction",
+  "listConnections",
+  "estimateStepCost"
 ]);
 function resolveMethodOrFail(name, metadataKeys) {
   if (metadataKeys.has(name)) return name;
@@ -2259,9 +2520,36 @@ async function getAllMethodKeys() {
   const { stepMetadata: stepMetadata2 } = await Promise.resolve().then(() => (init_metadata(), metadata_exports));
   return /* @__PURE__ */ new Set([...Object.keys(stepMetadata2), ...HELPER_NAMES]);
 }
-async function cmdList(asJson) {
+var HELPER_DESCRIPTIONS2 = {
+  listModels: "List all available AI models.",
+  listModelsByType: "List AI models filtered by type.",
+  listModelsSummary: "List all AI models (summary: id, name, type, tags).",
+  listModelsSummaryByType: "List AI models (summary) filtered by type.",
+  listConnectors: "List available connector services and their actions.",
+  getConnector: "Get details for a connector service.",
+  getConnectorAction: "Get full configuration for a connector action.",
+  listConnections: "List OAuth connections for the organization.",
+  estimateStepCost: "Estimate the cost of executing a step before running it.",
+  listAgents: "List all pre-built agents in the organization.",
+  runAgent: "Run a pre-built agent and wait for the result."
+};
+function buildSummary(stepMetadata2) {
+  const summary = {};
+  for (const [name, meta] of Object.entries(stepMetadata2)) {
+    summary[name] = meta.description;
+  }
+  for (const [name, desc] of Object.entries(HELPER_DESCRIPTIONS2)) {
+    summary[name] = desc;
+  }
+  return summary;
+}
+async function cmdList(asJson, asSummary) {
   const { stepMetadata: stepMetadata2 } = await Promise.resolve().then(() => (init_metadata(), metadata_exports));
-  if (asJson) {
+  if (asSummary) {
+    process.stdout.write(
+      JSON.stringify(buildSummary(stepMetadata2)) + "\n"
+    );
+  } else if (asJson) {
     const entries = Object.entries(stepMetadata2).map(([name, meta]) => ({
       method: camelToKebab(name),
       description: meta.description,
@@ -2293,8 +2581,13 @@ async function cmdInfo(rawMethod) {
     const helpers = {
       listModels: { desc: "List all available AI models.", input: "(none)", output: "{ models: MindStudioModel[] }" },
       listModelsByType: { desc: "List AI models filtered by type.", input: "modelType: string (required)", output: "{ models: MindStudioModel[] }" },
-      listConnectors: { desc: "List available connector services.", input: "(none)", output: "{ services: Array }" },
-      getConnector: { desc: "Get details for a connector service.", input: "serviceId: string (required)", output: "{ service: object }" }
+      listModelsSummary: { desc: "List all AI models (summary: id, name, type, tags).", input: "(none)", output: "{ models: MindStudioModelSummary[] }" },
+      listModelsSummaryByType: { desc: "List AI models (summary) filtered by type.", input: "modelType: string (required)", output: "{ models: MindStudioModelSummary[] }" },
+      listConnectors: { desc: "List available connector services and their actions.", input: "(none)", output: "{ services: ConnectorService[] }" },
+      getConnector: { desc: "Get details for a connector service.", input: "serviceId: string (required)", output: "{ service: ConnectorService }" },
+      getConnectorAction: { desc: "Get full configuration for a connector action.", input: "serviceId: string, actionId: string (both required)", output: "{ action: ConnectorActionDetail }" },
+      listConnections: { desc: "List OAuth connections for the organization.", input: "(none)", output: "{ connections: Connection[] }" },
+      estimateStepCost: { desc: "Estimate the cost of executing a step before running it.", input: "stepType: string (required), step: object, appId?: string, workflowId?: string", output: "{ costType?: string, estimates?: StepCostEstimateEntry[] }" }
     };
     const h = helpers[method];
     process.stderr.write(`
@@ -2376,10 +2669,32 @@ async function cmdExec(method, input, options) {
     result = await agent.listModels();
   } else if (method === "listModelsByType") {
     result = await agent.listModelsByType(input.modelType);
+  } else if (method === "listModelsSummary") {
+    result = await agent.listModelsSummary();
+  } else if (method === "listModelsSummaryByType") {
+    result = await agent.listModelsSummaryByType(
+      input.modelType
+    );
   } else if (method === "listConnectors") {
     result = await agent.listConnectors();
   } else if (method === "getConnector") {
     result = await agent.getConnector(input.serviceId);
+  } else if (method === "getConnectorAction") {
+    result = await agent.getConnectorAction(
+      input.serviceId,
+      input.actionId
+    );
+  } else if (method === "listConnections") {
+    result = await agent.listConnections();
+  } else if (method === "estimateStepCost") {
+    result = await agent.estimateStepCost(
+      input.stepType,
+      input.step,
+      {
+        appId: input.appId,
+        workflowId: input.workflowId
+      }
+    );
   } else {
     const { stepMetadata: stepMetadata2 } = await Promise.resolve().then(() => (init_metadata(), metadata_exports));
     const meta = stepMetadata2[method];
@@ -2494,7 +2809,7 @@ function isNewerVersion(current, latest) {
   return false;
 }
 async function checkForUpdate() {
-  const currentVersion = "0.0.20";
+  const currentVersion = "0.1.1";
   if (!currentVersion) return null;
   try {
     const { loadConfig: loadConfig2, saveConfig: saveConfig2 } = await Promise.resolve().then(() => (init_config(), config_exports));
@@ -2523,7 +2838,7 @@ async function checkForUpdate() {
   }
 }
 function printUpdateNotice(latestVersion) {
-  const currentVersion = "0.0.20";
+  const currentVersion = "0.1.1";
   process.stderr.write(
     `
   ${ansi.cyanBright("Update available")} ${ansi.gray(currentVersion + " \u2192")} ${ansi.cyanBold(latestVersion)}
@@ -2597,7 +2912,7 @@ async function cmdLogin(options) {
   process.stderr.write("\n");
   printLogo();
   process.stderr.write("\n");
-  const ver = "0.0.20";
+  const ver = "0.1.1";
   process.stderr.write(
     `  ${ansi.bold("MindStudio")} ${ansi.gray("CLI")}${ver ? " " + ansi.gray("v" + ver) : ""}
 `
@@ -2830,6 +3145,7 @@ async function main() {
       workflow: { type: "string" },
       version: { type: "string" },
       json: { type: "boolean", default: false },
+      summary: { type: "boolean", default: false },
       help: { type: "boolean", default: false }
     }
   });
@@ -2858,7 +3174,10 @@ async function main() {
       return;
     }
     if (command === "list") {
-      await cmdList(values.json);
+      await cmdList(
+        values.json,
+        values.summary
+      );
       return;
     }
     if (command === "agents") {