@mindstudio-ai/agent 0.1.0 → 0.1.1

package/README.md

@@ -4,7 +4,7 @@ Every AI model. Every integration. One SDK.
 
 [MindStudio](https://mindstudio.ai) gives you direct access to 200+ AI models and [1,000+ integrations](https://github.com/mindstudio-ai/mscr) — no separate API keys, no setup, no friction. This package is the developer toolkit: a TypeScript SDK, CLI, and MCP server that puts the entire platform at your fingertips.
 
-Generate text, images, video, and audio. Scrape the web. Search Google. Post to Slack. Read from Airtable. Send emails. Process media. Connect to 850+ third-party services. All with one API key, fully typed, and ready to use from code, the command line, or any MCP-compatible AI agent.
+Generate text, images, video, and audio. Scrape the web. Search Google. Post to Slack. Read from Airtable. Send emails. Process media. Run any of 850+ connector actions across third-party services. All with one API key, fully typed, and ready to use from code, the command line, or any MCP-compatible AI agent.
 
 ## Install
 
@@ -154,7 +154,7 @@ Model types: `llm_chat`, `image_generation`, `video_generation`, `video_analysis
 
 ## 1,000+ integrations
 
-850+ third-party connectors from the open-source [MindStudio Connector Registry (MSCR)](https://github.com/mindstudio-ai/mscr) — Slack, Google, HubSpot, Salesforce, Airtable, Notion, and hundreds more — alongside 140+ built-in actions for AI, media, web, and data processing.
+850+ connector actions from the open-source [MindStudio Connector Registry (MSCR)](https://github.com/mindstudio-ai/mscr) — across services like ActiveCampaign, Airtable, Apollo, Canva, ElevenLabs, MailChimp, Notion, and more — alongside 140+ built-in actions for AI, media, web, and data processing.
 
 ```typescript
 // Browse connectors and their actions

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.",
@@ -805,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.",
@@ -882,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.",
@@ -889,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",
@@ -980,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.",
@@ -1310,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);
   };
@@ -1412,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);
   };
@@ -1475,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);
   };
@@ -1586,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);
   };
@@ -1619,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);
   };
@@ -1661,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);
   };
@@ -1735,6 +1837,9 @@ function applyHelperMethods(AgentClass) {
   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"() {
@@ -1988,7 +2093,7 @@ async function startMcpServer(options) {
           capabilities: { tools: {} },
           serverInfo: {
             name: "mindstudio-agent",
-            version: "0.1.0"
+            version: "0.1.1"
           }
         });
         break;
@@ -2002,7 +2107,19 @@ 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(
@@ -2027,6 +2144,15 @@ async function startMcpServer(options) {
             );
           } 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") {
@@ -2081,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.",
@@ -2179,6 +2323,33 @@ var init_mcp = __esm({
         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.",
@@ -2226,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
@@ -2323,7 +2494,8 @@ var HELPER_NAMES = /* @__PURE__ */ new Set([
   "listConnectors",
   "getConnector",
   "getConnectorAction",
-  "listConnections"
+  "listConnections",
+  "estimateStepCost"
 ]);
 function resolveMethodOrFail(name, metadataKeys) {
   if (metadataKeys.has(name)) return name;
@@ -2348,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,
@@ -2387,7 +2586,8 @@ async function cmdInfo(rawMethod) {
       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[] }" }
+      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(`
@@ -2486,6 +2686,15 @@ async function cmdExec(method, input, options) {
     );
   } 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];
@@ -2600,7 +2809,7 @@ function isNewerVersion(current, latest) {
   return false;
 }
 async function checkForUpdate() {
-  const currentVersion = "0.1.0";
+  const currentVersion = "0.1.1";
   if (!currentVersion) return null;
   try {
     const { loadConfig: loadConfig2, saveConfig: saveConfig2 } = await Promise.resolve().then(() => (init_config(), config_exports));
@@ -2629,7 +2838,7 @@ async function checkForUpdate() {
   }
 }
 function printUpdateNotice(latestVersion) {
-  const currentVersion = "0.1.0";
+  const currentVersion = "0.1.1";
   process.stderr.write(
     `
   ${ansi.cyanBright("Update available")} ${ansi.gray(currentVersion + " \u2192")} ${ansi.cyanBold(latestVersion)}
@@ -2703,7 +2912,7 @@ async function cmdLogin(options) {
   process.stderr.write("\n");
   printLogo();
   process.stderr.write("\n");
-  const ver = "0.1.0";
+  const ver = "0.1.1";
   process.stderr.write(
     `  ${ansi.bold("MindStudio")} ${ansi.gray("CLI")}${ver ? " " + ansi.gray("v" + ver) : ""}
 `
@@ -2936,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 }
     }
   });
@@ -2964,7 +3174,10 @@ async function main() {
       return;
     }
     if (command === "list") {
-      await cmdList(values.json);
+      await cmdList(
+        values.json,
+        values.summary
+      );
       return;
     }
     if (command === "agents") {