@mindstudio-ai/agent 0.1.0 → 0.1.3

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,29 @@ 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);
+  };
+  proto.changeName = function(displayName) {
+    return this._request("POST", "/account/change-name", { displayName }).then(() => {
+    });
+  };
+  proto.changeProfilePicture = function(profilePictureUrl) {
+    return this._request("POST", "/account/change-profile-picture", { profilePictureUrl }).then(() => {
+    });
+  };
+  proto.uploadFile = async function(content, options) {
+    const { data } = await this._request("POST", "/account/upload", { extension: options.extension, ...options.type != null && { type: options.type } });
+    const { uploadUrl, url } = data;
+    const buf = content.buffer.slice(content.byteOffset, content.byteOffset + content.byteLength);
+    const res = await fetch(uploadUrl, {
+      method: "PUT",
+      body: buf,
+      headers: options.type ? { "Content-Type": options.type } : {}
+    });
+    if (!res.ok) throw new Error(`Upload failed: ${res.status} ${res.statusText}`);
+    return { url };
+  };
 }
 var init_helpers = __esm({
   "src/generated/helpers.ts"() {
@@ -1936,6 +2061,8 @@ __export(mcp_exports, {
   startMcpServer: () => startMcpServer
 });
 import { createInterface } from "readline";
+import { readFileSync as readFileSync2 } from "fs";
+import { extname } from "path";
 function send(message) {
   process.stdout.write(JSON.stringify(message) + "\n");
 }
@@ -1988,8 +2115,9 @@ async function startMcpServer(options) {
           capabilities: { tools: {} },
           serverInfo: {
             name: "mindstudio-agent",
-            version: "0.1.0"
-          }
+            version: "0.1.3"
+          },
+          instructions: "Welcome to MindStudio \u2014 a platform with 200+ AI models, 850+ third-party integrations, and pre-built agents.\n\nGetting started:\n1. Call `listAgents` to verify your connection and see available agents.\n2. Call `changeName` to set your display name \u2014 use your name or whatever your user calls you. This is how you'll appear in MindStudio request logs.\n3. If you have a profile picture or icon, call `uploadFile` to upload it, then `changeProfilePicture` with the returned URL. This helps users identify your requests in their logs.\n4. Call `listSteps` to discover all available step methods and helpers.\n\nThen use the tools to generate text, images, video, audio, search the web, work with data sources, run agents, and more."
         });
         break;
       case "notifications/initialized":
@@ -2002,7 +2130,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 +2167,35 @@ 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 === "changeName") {
+            await getAgent().changeName(
+              args.displayName
+            );
+            result = { success: true };
+          } else if (toolName === "changeProfilePicture") {
+            await getAgent().changeProfilePicture(
+              args.profilePictureUrl
+            );
+            result = { success: true };
+          } else if (toolName === "uploadFile") {
+            const filePath = args.filePath;
+            const ext = extname(filePath).slice(1).toLowerCase();
+            if (!ext) throw new Error("Cannot determine file extension from path.");
+            const content = readFileSync2(filePath);
+            const mimeType = MIME_TYPES[ext];
+            result = await getAgent().uploadFile(content, {
+              extension: ext,
+              ...mimeType && { type: mimeType }
+            });
           } else if (toolName === "listAgents") {
             result = await getAgent().listAgents();
           } else if (toolName === "runAgent") {
@@ -2081,13 +2250,50 @@ async function startMcpServer(options) {
     }
   }
 }
-var MCP_PROTOCOL_VERSION, HELPER_TOOLS;
+var MCP_PROTOCOL_VERSION, MIME_TYPES, HELPER_DESCRIPTIONS, HELPER_TOOLS;
 var init_mcp = __esm({
   "src/mcp.ts"() {
     "use strict";
     init_client();
     MCP_PROTOCOL_VERSION = "2024-11-05";
+    MIME_TYPES = {
+      png: "image/png",
+      jpg: "image/jpeg",
+      jpeg: "image/jpeg",
+      gif: "image/gif",
+      webp: "image/webp",
+      svg: "image/svg+xml",
+      mp4: "video/mp4",
+      webm: "video/webm",
+      mp3: "audio/mpeg",
+      wav: "audio/wav",
+      pdf: "application/pdf",
+      json: "application/json",
+      txt: "text/plain",
+      csv: "text/csv"
+    };
+    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.",
+      changeName: "Update the display name of the authenticated agent.",
+      changeProfilePicture: "Update the profile picture of the authenticated agent.",
+      uploadFile: "Upload a file to the MindStudio CDN.",
+      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. Call this to discover what steps and helpers are available, then call a specific method by name. Tip: if you haven't already, call `changeName` to set your display name first.",
+        inputSchema: { type: "object", properties: {} }
+      },
       {
         name: "listModels",
         description: "List all available AI models across all categories.",
@@ -2179,6 +2385,75 @@ 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: "changeName",
+        description: "Update the display name of the authenticated agent. Useful for agents to set their own name after connecting.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            displayName: {
+              type: "string",
+              description: "The new display name."
+            }
+          },
+          required: ["displayName"]
+        }
+      },
+      {
+        name: "changeProfilePicture",
+        description: "Update the profile picture of the authenticated agent. Useful for agents to set their own avatar after connecting.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            profilePictureUrl: {
+              type: "string",
+              description: "URL of the new profile picture."
+            }
+          },
+          required: ["profilePictureUrl"]
+        }
+      },
+      {
+        name: "uploadFile",
+        description: "Upload a local file to the MindStudio CDN. Returns the permanent public URL.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            filePath: {
+              type: "string",
+              description: "Absolute or relative path to the file to upload."
+            }
+          },
+          required: ["filePath"]
+        }
+      },
       {
         name: "listAgents",
         description: "List all pre-built agents in the organization along with org metadata.",
@@ -2218,15 +2493,18 @@ var init_mcp = __esm({
 // src/cli.ts
 import { parseArgs } from "util";
 import { execSync } from "child_process";
+import { readFileSync as readFileSync3 } from "fs";
+import { extname as extname2 } from "path";
 var HELP = `Usage: mindstudio <command | method> [options]
 
 Commands:
   login                       Authenticate with MindStudio (opens browser)
   logout                      Clear stored credentials
   whoami                      Show current authentication status
+  upload <filepath>             Upload a file to the MindStudio CDN
   <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 +2601,10 @@ var HELPER_NAMES = /* @__PURE__ */ new Set([
   "listConnectors",
   "getConnector",
   "getConnectorAction",
-  "listConnections"
+  "listConnections",
+  "estimateStepCost",
+  "changeName",
+  "changeProfilePicture"
 ]);
 function resolveMethodOrFail(name, metadataKeys) {
   if (metadataKeys.has(name)) return name;
@@ -2348,9 +2629,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.",
+  changeName: "Update the display name of the authenticated agent.",
+  changeProfilePicture: "Update the profile picture of the authenticated agent.",
+  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,
@@ -2380,14 +2688,61 @@ async function cmdInfo(rawMethod) {
   const method = resolveMethodOrFail(rawMethod, allKeys);
   if (HELPER_NAMES.has(method)) {
     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[] }" },
-      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[] }" }
+      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[] }"
+      },
+      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[] }"
+      },
+      changeName: {
+        desc: "Update the display name of the authenticated agent.",
+        input: "displayName: string (required)",
+        output: "(none)"
+      },
+      changeProfilePicture: {
+        desc: "Update the profile picture of the authenticated agent.",
+        input: "profilePictureUrl: string (required)",
+        output: "(none)"
+      }
     };
     const h = helpers[method];
     process.stderr.write(`
@@ -2446,10 +2801,12 @@ async function cmdInfo(rawMethod) {
   process.stderr.write(out.join("\n") + "\n");
 }
 function formatPropType(prop) {
-  if (prop.enum) return prop.enum.map((v) => JSON.stringify(v)).join(" | ");
+  if (prop.enum)
+    return prop.enum.map((v) => JSON.stringify(v)).join(" | ");
   if (prop.type === "array") return "array";
   if (prop.type === "object") return "object";
-  if (typeof prop.type === "string") return prop.type === "integer" ? "number" : prop.type;
+  if (typeof prop.type === "string")
+    return prop.type === "integer" ? "number" : prop.type;
   return "string";
 }
 async function cmdExec(method, input, options) {
@@ -2472,9 +2829,7 @@ async function cmdExec(method, input, options) {
   } else if (method === "listModelsSummary") {
     result = await agent.listModelsSummary();
   } else if (method === "listModelsSummaryByType") {
-    result = await agent.listModelsSummaryByType(
-      input.modelType
-    );
+    result = await agent.listModelsSummaryByType(input.modelType);
   } else if (method === "listConnectors") {
     result = await agent.listConnectors();
   } else if (method === "getConnector") {
@@ -2486,6 +2841,21 @@ 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 if (method === "changeName") {
+    await agent.changeName(input.displayName);
+    result = { success: true };
+  } else if (method === "changeProfilePicture") {
+    await agent.changeProfilePicture(input.profilePictureUrl);
+    result = { success: true };
   } else {
     const { stepMetadata: stepMetadata2 } = await Promise.resolve().then(() => (init_metadata(), metadata_exports));
     const meta = stepMetadata2[method];
@@ -2540,10 +2910,8 @@ async function cmdAgents(asJson, options) {
     );
     for (const app of result.apps) {
       const desc = app.description || "(no description)";
-      process.stdout.write(
-        `${app.name.padEnd(maxLen)}  ${app.id}  ${desc}
-`
-      );
+      process.stdout.write(`${app.name.padEnd(maxLen)}  ${app.id}  ${desc}
+`);
     }
   }
 }
@@ -2577,6 +2945,41 @@ async function cmdRun(appId, variables, options) {
     process.stdout.write(JSON.stringify(result, null, 2) + "\n");
   }
 }
+var MIME_TYPES2 = {
+  png: "image/png",
+  jpg: "image/jpeg",
+  jpeg: "image/jpeg",
+  gif: "image/gif",
+  webp: "image/webp",
+  svg: "image/svg+xml",
+  mp4: "video/mp4",
+  webm: "video/webm",
+  mp3: "audio/mpeg",
+  wav: "audio/wav",
+  pdf: "application/pdf",
+  json: "application/json",
+  txt: "text/plain",
+  csv: "text/csv"
+};
+async function cmdUpload(filePath, options) {
+  const ext = extname2(filePath).slice(1).toLowerCase();
+  if (!ext) fatal("Cannot determine file extension. Please provide a file with an extension.");
+  const content = readFileSync3(filePath);
+  const mimeType = MIME_TYPES2[ext];
+  const { MindStudioAgent: MindStudioAgent2 } = await Promise.resolve().then(() => (init_client(), client_exports));
+  await Promise.resolve().then(() => (init_helpers(), helpers_exports)).then(
+    (m) => m.applyHelperMethods(MindStudioAgent2)
+  );
+  const agent = new MindStudioAgent2({
+    apiKey: options.apiKey,
+    baseUrl: options.baseUrl
+  });
+  const { url } = await agent.uploadFile(content, {
+    extension: ext,
+    ...mimeType && { type: mimeType }
+  });
+  process.stdout.write(url + "\n");
+}
 var ansi = {
   cyan: (s) => `\x1B[36m${s}\x1B[0m`,
   cyanBright: (s) => `\x1B[96m${s}\x1B[0m`,
@@ -2600,7 +3003,7 @@ function isNewerVersion(current, latest) {
   return false;
 }
 async function checkForUpdate() {
-  const currentVersion = "0.1.0";
+  const currentVersion = "0.1.3";
   if (!currentVersion) return null;
   try {
     const { loadConfig: loadConfig2, saveConfig: saveConfig2 } = await Promise.resolve().then(() => (init_config(), config_exports));
@@ -2629,7 +3032,7 @@ async function checkForUpdate() {
   }
 }
 function printUpdateNotice(latestVersion) {
-  const currentVersion = "0.1.0";
+  const currentVersion = "0.1.3";
   process.stderr.write(
     `
   ${ansi.cyanBright("Update available")} ${ansi.gray(currentVersion + " \u2192")} ${ansi.cyanBold(latestVersion)}
@@ -2703,9 +3106,9 @@ async function cmdLogin(options) {
   process.stderr.write("\n");
   printLogo();
   process.stderr.write("\n");
-  const ver = "0.1.0";
+  const ver = "0.1.3";
   process.stderr.write(
-    `  ${ansi.bold("MindStudio")} ${ansi.gray("CLI")}${ver ? " " + ansi.gray("v" + ver) : ""}
+    `  ${ansi.bold("MindStudio Agent")} ${ver ? " " + ansi.gray("v" + ver) : ""}
 `
   );
   process.stderr.write(
@@ -2722,12 +3125,10 @@ async function cmdLogin(options) {
   );
   await waitForKeypress();
   process.stderr.write("\x1B[4A\r\x1B[J");
-  process.stderr.write(
-    `  ${ansi.gray("Requesting authorization...")}
-`
-  );
+  process.stderr.write(`  ${ansi.gray("Requesting authorization...")}
+`);
   const authRes = await fetch(
-    `${baseUrl}/developer/v2/request-auth-url`,
+    `${baseUrl}/developer/v2/request-auth-url?agent=true`,
     {
       headers: {
         "Content-Type": "application/json",
@@ -2771,9 +3172,7 @@ async function cmdLogin(options) {
     });
     if (!pollRes.ok) {
       process.stderr.write("\n");
-      fatal(
-        `Poll request failed: ${pollRes.status} ${pollRes.statusText}`
-      );
+      fatal(`Poll request failed: ${pollRes.status} ${pollRes.statusText}`);
     }
     const result = await pollRes.json();
     if (result.status === "completed" && result.apiKey) {
@@ -2806,10 +3205,8 @@ async function cmdLogout() {
   const { loadConfig: loadConfig2, clearConfig: clearConfig2, getConfigPath: getConfigPath2 } = await Promise.resolve().then(() => (init_config(), config_exports));
   const config = loadConfig2();
   if (!config.apiKey) {
-    process.stderr.write(
-      `  ${ansi.gray("Not currently logged in.")}
-`
-    );
+    process.stderr.write(`  ${ansi.gray("Not currently logged in.")}
+`);
     return;
   }
   clearConfig2();
@@ -2936,12 +3333,28 @@ async function main() {
       workflow: { type: "string" },
       version: { type: "string" },
       json: { type: "boolean", default: false },
+      summary: { type: "boolean", default: false },
       help: { type: "boolean", default: false }
     }
   });
-  if (values.help || positionals.length === 0) {
+  if (values.help) {
+    printHelp();
+    process.exit(0);
+  }
+  if (positionals.length === 0) {
+    const hasAuth = values["api-key"] || process.env.MINDSTUDIO_API_KEY || process.env.CALLBACK_TOKEN;
+    if (!hasAuth) {
+      const { loadConfig: loadConfig2 } = await Promise.resolve().then(() => (init_config(), config_exports));
+      const config = loadConfig2();
+      if (!config.apiKey) {
+        await cmdLogin({
+          baseUrl: values["base-url"]
+        });
+        return;
+      }
+    }
     printHelp();
-    process.exit(positionals.length === 0 ? 1 : 0);
+    process.exit(1);
   }
   const command = positionals[0];
   const updatePromise = command !== "mcp" && command !== "login" ? checkForUpdate() : Promise.resolve(null);
@@ -2964,7 +3377,7 @@ async function main() {
       return;
     }
     if (command === "list") {
-      await cmdList(values.json);
+      await cmdList(values.json, values.summary);
       return;
     }
     if (command === "agents") {
@@ -2978,9 +3391,7 @@ async function main() {
       const appId = positionals[1];
       if (!appId)
         fatal("Missing app ID. Usage: mindstudio run <appId> [json | --flags]");
-      const runArgv = process.argv.slice(
-        process.argv.indexOf("run") + 2
-      );
+      const runArgv = process.argv.slice(process.argv.indexOf("run") + 2);
       const stepArgs = [];
       for (let i = 0; i < runArgv.length; i++) {
         const arg = runArgv[i];
@@ -3025,6 +3436,16 @@ async function main() {
       });
       return;
     }
+    if (command === "upload") {
+      const filePath = positionals[1];
+      if (!filePath)
+        fatal("Missing file path. Usage: mindstudio upload <filepath>");
+      await cmdUpload(filePath, {
+        apiKey: values["api-key"],
+        baseUrl: values["base-url"]
+      });
+      return;
+    }
     if (command === "mcp") {
       const { startMcpServer: startMcpServer2 } = await Promise.resolve().then(() => (init_mcp(), mcp_exports));
       await startMcpServer2({
@@ -3042,9 +3463,7 @@ async function main() {
     }
     const split = findMethodSplit(process.argv.slice(2));
     if (!split)
-      fatal(
-        "Missing method name. Usage: mindstudio <method> [json | --flags]"
-      );
+      fatal("Missing method name. Usage: mindstudio <method> [json | --flags]");
     const { rawMethod, stepArgv } = split;
     const allKeys = await getAllMethodKeys();
     const method = resolveMethodOrFail(rawMethod, allKeys);