@mindstudio-ai/agent 0.1.44 → 0.1.46

package/dist/index.js

@@ -1693,491 +1693,6 @@ function resolveTable(databases, tableName, databaseHint) {
   );
 }
 
-// src/generated/steps.ts
-function applyStepMethods(AgentClass) {
-  const proto = AgentClass.prototype;
-  proto.activeCampaignAddNote = function(step, options) {
-    return this.executeStep("activeCampaignAddNote", step, options);
-  };
-  proto.activeCampaignCreateContact = function(step, options) {
-    return this.executeStep("activeCampaignCreateContact", step, options);
-  };
-  proto.addSubtitlesToVideo = function(step, options) {
-    return this.executeStep("addSubtitlesToVideo", step, options);
-  };
-  proto.airtableCreateUpdateRecord = function(step, options) {
-    return this.executeStep("airtableCreateUpdateRecord", step, options);
-  };
-  proto.airtableDeleteRecord = function(step, options) {
-    return this.executeStep("airtableDeleteRecord", step, options);
-  };
-  proto.airtableGetRecord = function(step, options) {
-    return this.executeStep("airtableGetRecord", step, options);
-  };
-  proto.airtableGetTableRecords = function(step, options) {
-    return this.executeStep("airtableGetTableRecords", step, options);
-  };
-  proto.analyzeImage = function(step, options) {
-    return this.executeStep("analyzeImage", step, options);
-  };
-  proto.analyzeVideo = function(step, options) {
-    return this.executeStep("analyzeVideo", step, options);
-  };
-  proto.captureThumbnail = function(step, options) {
-    return this.executeStep("captureThumbnail", step, options);
-  };
-  proto.checkAppRole = function(step, options) {
-    return this.executeStep("checkAppRole", step, options);
-  };
-  proto.codaCreateUpdatePage = function(step, options) {
-    return this.executeStep("codaCreateUpdatePage", step, options);
-  };
-  proto.codaCreateUpdateRow = function(step, options) {
-    return this.executeStep("codaCreateUpdateRow", step, options);
-  };
-  proto.codaFindRow = function(step, options) {
-    return this.executeStep("codaFindRow", step, options);
-  };
-  proto.codaGetPage = function(step, options) {
-    return this.executeStep("codaGetPage", step, options);
-  };
-  proto.codaGetTableRows = function(step, options) {
-    return this.executeStep("codaGetTableRows", step, options);
-  };
-  proto.convertPdfToImages = function(step, options) {
-    return this.executeStep("convertPdfToImages", step, options);
-  };
-  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);
-  };
-  proto.createGoogleDoc = function(step, options) {
-    return this.executeStep("createGoogleDoc", step, options);
-  };
-  proto.createGoogleSheet = function(step, options) {
-    return this.executeStep("createGoogleSheet", step, options);
-  };
-  proto.deleteDataSource = function(step, options) {
-    return this.executeStep("deleteDataSource", step, options);
-  };
-  proto.deleteDataSourceDocument = function(step, options) {
-    return this.executeStep("deleteDataSourceDocument", step, options);
-  };
-  proto.deleteGmailEmail = function(step, options) {
-    return this.executeStep("deleteGmailEmail", step, options);
-  };
-  proto.deleteGoogleCalendarEvent = function(step, options) {
-    return this.executeStep("deleteGoogleCalendarEvent", step, options);
-  };
-  proto.deleteGoogleSheetRows = function(step, options) {
-    return this.executeStep("deleteGoogleSheetRows", step, options);
-  };
-  proto.detectChanges = function(step, options) {
-    return this.executeStep("detectChanges", step, options);
-  };
-  proto.detectPII = function(step, options) {
-    return this.executeStep("detectPII", step, options);
-  };
-  proto.discordEditMessage = function(step, options) {
-    return this.executeStep("discordEditMessage", step, options);
-  };
-  proto.discordSendFollowUp = function(step, options) {
-    return this.executeStep("discordSendFollowUp", step, options);
-  };
-  proto.discordSendMessage = function(step, options) {
-    return this.executeStep("discordSendMessage", step, options);
-  };
-  proto.downloadVideo = function(step, options) {
-    return this.executeStep("downloadVideo", step, options);
-  };
-  proto.enhanceImageGenerationPrompt = function(step, options) {
-    return this.executeStep("enhanceImageGenerationPrompt", step, options);
-  };
-  proto.enhanceVideoGenerationPrompt = function(step, options) {
-    return this.executeStep("enhanceVideoGenerationPrompt", step, options);
-  };
-  proto.enrichPerson = function(step, options) {
-    return this.executeStep("enrichPerson", step, options);
-  };
-  proto.extractAudioFromVideo = function(step, options) {
-    return this.executeStep("extractAudioFromVideo", step, options);
-  };
-  proto.extractText = function(step, options) {
-    return this.executeStep("extractText", step, options);
-  };
-  proto.fetchDataSourceDocument = function(step, options) {
-    return this.executeStep("fetchDataSourceDocument", step, options);
-  };
-  proto.fetchGoogleDoc = function(step, options) {
-    return this.executeStep("fetchGoogleDoc", step, options);
-  };
-  proto.fetchGoogleSheet = function(step, options) {
-    return this.executeStep("fetchGoogleSheet", step, options);
-  };
-  proto.fetchSlackChannelHistory = function(step, options) {
-    return this.executeStep("fetchSlackChannelHistory", step, options);
-  };
-  proto.fetchYoutubeCaptions = function(step, options) {
-    return this.executeStep("fetchYoutubeCaptions", step, options);
-  };
-  proto.fetchYoutubeChannel = function(step, options) {
-    return this.executeStep("fetchYoutubeChannel", step, options);
-  };
-  proto.fetchYoutubeComments = function(step, options) {
-    return this.executeStep("fetchYoutubeComments", step, options);
-  };
-  proto.fetchYoutubeVideo = function(step, options) {
-    return this.executeStep("fetchYoutubeVideo", step, options);
-  };
-  proto.generateChart = function(step, options) {
-    return this.executeStep("generateChart", step, options);
-  };
-  proto.generateImage = function(step, options) {
-    return this.executeStep("generateImage", step, options);
-  };
-  proto.generateLipsync = function(step, options) {
-    return this.executeStep("generateLipsync", step, options);
-  };
-  proto.generateMusic = function(step, options) {
-    return this.executeStep("generateMusic", step, options);
-  };
-  proto.generateAsset = function(step, options) {
-    return this.executeStep("generatePdf", step, options);
-  };
-  proto.generateStaticVideoFromImage = function(step, options) {
-    return this.executeStep("generateStaticVideoFromImage", step, options);
-  };
-  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);
-  };
-  proto.getGoogleDriveFile = function(step, options) {
-    return this.executeStep("getGoogleDriveFile", step, options);
-  };
-  proto.getGoogleSheetInfo = function(step, options) {
-    return this.executeStep("getGoogleSheetInfo", step, options);
-  };
-  proto.getMediaMetadata = function(step, options) {
-    return this.executeStep("getMediaMetadata", step, options);
-  };
-  proto.httpRequest = function(step, options) {
-    return this.executeStep("httpRequest", step, options);
-  };
-  proto.hubspotCreateCompany = function(step, options) {
-    return this.executeStep("hubspotCreateCompany", step, options);
-  };
-  proto.hubspotCreateContact = function(step, options) {
-    return this.executeStep("hubspotCreateContact", step, options);
-  };
-  proto.hubspotGetCompany = function(step, options) {
-    return this.executeStep("hubspotGetCompany", step, options);
-  };
-  proto.hubspotGetContact = function(step, options) {
-    return this.executeStep("hubspotGetContact", step, options);
-  };
-  proto.hunterApiCompanyEnrichment = function(step, options) {
-    return this.executeStep("hunterApiCompanyEnrichment", step, options);
-  };
-  proto.hunterApiDomainSearch = function(step, options) {
-    return this.executeStep("hunterApiDomainSearch", step, options);
-  };
-  proto.hunterApiEmailFinder = function(step, options) {
-    return this.executeStep("hunterApiEmailFinder", step, options);
-  };
-  proto.hunterApiEmailVerification = function(step, options) {
-    return this.executeStep("hunterApiEmailVerification", step, options);
-  };
-  proto.hunterApiPersonEnrichment = function(step, options) {
-    return this.executeStep("hunterApiPersonEnrichment", step, options);
-  };
-  proto.imageFaceSwap = function(step, options) {
-    return this.executeStep("imageFaceSwap", step, options);
-  };
-  proto.imageRemoveWatermark = function(step, options) {
-    return this.executeStep("imageRemoveWatermark", step, options);
-  };
-  proto.insertVideoClips = function(step, options) {
-    return this.executeStep("insertVideoClips", step, options);
-  };
-  proto.listDataSources = function(step, options) {
-    return this.executeStep("listDataSources", step, options);
-  };
-  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);
-  };
-  proto.makeDotComRunScenario = function(step, options) {
-    return this.executeStep("makeDotComRunScenario", step, options);
-  };
-  proto.mergeAudio = function(step, options) {
-    return this.executeStep("mergeAudio", step, options);
-  };
-  proto.mergeVideos = function(step, options) {
-    return this.executeStep("mergeVideos", step, options);
-  };
-  proto.mixAudioIntoVideo = function(step, options) {
-    return this.executeStep("mixAudioIntoVideo", step, options);
-  };
-  proto.muteVideo = function(step, options) {
-    return this.executeStep("muteVideo", step, options);
-  };
-  proto.n8nRunNode = function(step, options) {
-    return this.executeStep("n8nRunNode", step, options);
-  };
-  proto.notionCreatePage = function(step, options) {
-    return this.executeStep("notionCreatePage", step, options);
-  };
-  proto.notionUpdatePage = function(step, options) {
-    return this.executeStep("notionUpdatePage", step, options);
-  };
-  proto.peopleSearch = function(step, options) {
-    return this.executeStep("peopleSearch", step, options);
-  };
-  proto.postToLinkedIn = function(step, options) {
-    return this.executeStep("postToLinkedIn", step, options);
-  };
-  proto.postToSlackChannel = function(step, options) {
-    return this.executeStep("postToSlackChannel", step, options);
-  };
-  proto.postToX = function(step, options) {
-    return this.executeStep("postToX", step, options);
-  };
-  proto.postToZapier = function(step, options) {
-    return this.executeStep("postToZapier", step, options);
-  };
-  proto.queryAppDatabase = function(step, options) {
-    return this.executeStep("queryAppDatabase", step, options);
-  };
-  proto.queryDataSource = function(step, options) {
-    return this.executeStep("queryDataSource", step, options);
-  };
-  proto.queryExternalDatabase = function(step, options) {
-    return this.executeStep("queryExternalDatabase", step, options);
-  };
-  proto.redactPII = function(step, options) {
-    return this.executeStep("redactPII", step, options);
-  };
-  proto.removeBackgroundFromImage = function(step, options) {
-    return this.executeStep("removeBackgroundFromImage", step, options);
-  };
-  proto.replyToGmailEmail = function(step, options) {
-    return this.executeStep("replyToGmailEmail", step, options);
-  };
-  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);
-  };
-  proto.scrapeFacebookPage = function(step, options) {
-    return this.executeStep("scrapeFacebookPage", step, options);
-  };
-  proto.scrapeFacebookPosts = function(step, options) {
-    return this.executeStep("scrapeFacebookPosts", step, options);
-  };
-  proto.scrapeInstagramComments = function(step, options) {
-    return this.executeStep("scrapeInstagramComments", step, options);
-  };
-  proto.scrapeInstagramMentions = function(step, options) {
-    return this.executeStep("scrapeInstagramMentions", step, options);
-  };
-  proto.scrapeInstagramPosts = function(step, options) {
-    return this.executeStep("scrapeInstagramPosts", step, options);
-  };
-  proto.scrapeInstagramProfile = function(step, options) {
-    return this.executeStep("scrapeInstagramProfile", step, options);
-  };
-  proto.scrapeInstagramReels = function(step, options) {
-    return this.executeStep("scrapeInstagramReels", step, options);
-  };
-  proto.scrapeLinkedInCompany = function(step, options) {
-    return this.executeStep("scrapeLinkedInCompany", step, options);
-  };
-  proto.scrapeLinkedInProfile = function(step, options) {
-    return this.executeStep("scrapeLinkedInProfile", step, options);
-  };
-  proto.scrapeMetaThreadsProfile = function(step, options) {
-    return this.executeStep("scrapeMetaThreadsProfile", step, options);
-  };
-  proto.scrapeUrl = function(step, options) {
-    return this.executeStep("scrapeUrl", step, options);
-  };
-  proto.scrapeXPost = function(step, options) {
-    return this.executeStep("scrapeXPost", step, options);
-  };
-  proto.scrapeXProfile = function(step, options) {
-    return this.executeStep("scrapeXProfile", step, options);
-  };
-  proto.screenshotUrl = function(step, options) {
-    return this.executeStep("screenshotUrl", step, options);
-  };
-  proto.searchGmailEmails = function(step, options) {
-    return this.executeStep("searchGmailEmails", step, options);
-  };
-  proto.searchGoogle = function(step, options) {
-    return this.executeStep("searchGoogle", step, options);
-  };
-  proto.searchGoogleCalendarEvents = function(step, options) {
-    return this.executeStep("searchGoogleCalendarEvents", step, options);
-  };
-  proto.searchGoogleDrive = function(step, options) {
-    return this.executeStep("searchGoogleDrive", step, options);
-  };
-  proto.searchGoogleImages = function(step, options) {
-    return this.executeStep("searchGoogleImages", step, options);
-  };
-  proto.searchGoogleNews = function(step, options) {
-    return this.executeStep("searchGoogleNews", step, options);
-  };
-  proto.searchGoogleTrends = function(step, options) {
-    return this.executeStep("searchGoogleTrends", step, options);
-  };
-  proto.searchPerplexity = function(step, options) {
-    return this.executeStep("searchPerplexity", step, options);
-  };
-  proto.searchXPosts = function(step, options) {
-    return this.executeStep("searchXPosts", step, options);
-  };
-  proto.searchYoutube = function(step, options) {
-    return this.executeStep("searchYoutube", step, options);
-  };
-  proto.searchYoutubeTrends = function(step, options) {
-    return this.executeStep("searchYoutubeTrends", step, options);
-  };
-  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.sendSlackDirectMessage = function(step, options) {
-    return this.executeStep("sendSlackDirectMessage", 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);
-  };
-  proto.setVariable = function(step, options) {
-    return this.executeStep("setVariable", step, options);
-  };
-  proto.telegramEditMessage = function(step, options) {
-    return this.executeStep("telegramEditMessage", step, options);
-  };
-  proto.telegramReplyToMessage = function(step, options) {
-    return this.executeStep("telegramReplyToMessage", step, options);
-  };
-  proto.telegramSendAudio = function(step, options) {
-    return this.executeStep("telegramSendAudio", step, options);
-  };
-  proto.telegramSendFile = function(step, options) {
-    return this.executeStep("telegramSendFile", step, options);
-  };
-  proto.telegramSendImage = function(step, options) {
-    return this.executeStep("telegramSendImage", step, options);
-  };
-  proto.telegramSendMessage = function(step, options) {
-    return this.executeStep("telegramSendMessage", step, options);
-  };
-  proto.telegramSendVideo = function(step, options) {
-    return this.executeStep("telegramSendVideo", step, options);
-  };
-  proto.telegramSetTyping = function(step, options) {
-    return this.executeStep("telegramSetTyping", step, options);
-  };
-  proto.textToSpeech = function(step, options) {
-    return this.executeStep("textToSpeech", step, options);
-  };
-  proto.transcribeAudio = function(step, options) {
-    return this.executeStep("transcribeAudio", step, options);
-  };
-  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);
-  };
-  proto.updateGoogleDoc = function(step, options) {
-    return this.executeStep("updateGoogleDoc", step, options);
-  };
-  proto.updateGoogleSheet = function(step, options) {
-    return this.executeStep("updateGoogleSheet", step, options);
-  };
-  proto.uploadDataSourceDocument = function(step, options) {
-    return this.executeStep("uploadDataSourceDocument", step, options);
-  };
-  proto.upscaleImage = function(step, options) {
-    return this.executeStep("upscaleImage", step, options);
-  };
-  proto.upscaleVideo = function(step, options) {
-    return this.executeStep("upscaleVideo", step, options);
-  };
-  proto.generateText = function(step, options) {
-    return this.executeStep("userMessage", step, options);
-  };
-  proto.videoFaceSwap = function(step, options) {
-    return this.executeStep("videoFaceSwap", step, options);
-  };
-  proto.videoRemoveBackground = function(step, options) {
-    return this.executeStep("videoRemoveBackground", step, options);
-  };
-  proto.videoRemoveWatermark = function(step, options) {
-    return this.executeStep("videoRemoveWatermark", step, options);
-  };
-  proto.watermarkImage = function(step, options) {
-    return this.executeStep("watermarkImage", step, options);
-  };
-  proto.watermarkVideo = function(step, options) {
-    return this.executeStep("watermarkVideo", step, options);
-  };
-}
-
 // src/generated/metadata.ts
 var stepMetadata = {
   "activeCampaignAddNote": {
@@ -3351,6 +2866,672 @@ var stepMetadata = {
   }
 };
 
+// src/task/index.ts
+function resolveStepType(name) {
+  const meta = stepMetadata[name];
+  return meta ? meta.stepType : name;
+}
+function mapTools(tools) {
+  return tools.map((t) => {
+    const method = typeof t === "string" ? t : t.method;
+    const stepType = resolveStepType(method);
+    const defaults = typeof t === "object" ? t.defaults : void 0;
+    return defaults ? { stepType, defaults } : { stepType };
+  });
+}
+function buildTaskRequestBody(options) {
+  return {
+    prompt: options.prompt,
+    input: options.input,
+    tools: mapTools(options.tools),
+    structuredOutputExample: options.structuredOutputExample,
+    model: options.model,
+    ...options.maxTurns != null && { maxTurns: options.maxTurns },
+    ...options.appId != null && { appId: options.appId },
+    ...options.threadId != null && { threadId: options.threadId }
+  };
+}
+function sleep2(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function runTaskPoll(httpConfig, body) {
+  const { data } = await request(
+    httpConfig,
+    "POST",
+    "/task",
+    body
+  );
+  const pollUrl = `${httpConfig.baseUrl}/developer/v2/task/poll/${data.taskToken}`;
+  let pollDelay = 300;
+  while (true) {
+    await sleep2(pollDelay);
+    pollDelay = Math.min(pollDelay * 1.5, 3e3);
+    const res = await fetch(pollUrl, {
+      headers: { "User-Agent": "@mindstudio-ai/agent" }
+    });
+    if (res.status === 404) {
+      throw new MindStudioError(
+        "Task poll token not found or expired.",
+        "poll_token_expired",
+        404
+      );
+    }
+    if (!res.ok) {
+      const errorBody = await res.json().catch(() => ({}));
+      throw new MindStudioError(
+        errorBody.message ?? errorBody.error ?? `Task poll failed: ${res.status} ${res.statusText}`,
+        errorBody.code ?? "poll_error",
+        res.status,
+        errorBody
+      );
+    }
+    const poll = await res.json();
+    if (poll.status === "pending") continue;
+    if (poll.status === "error") {
+      throw new MindStudioError(
+        poll.error ?? "Task execution failed.",
+        "task_execution_error",
+        500
+      );
+    }
+    return {
+      output: poll.output,
+      turns: poll.turns ?? 0,
+      usage: poll.usage ?? { inputTokens: 0, outputTokens: 0, totalBillingCost: 0 }
+    };
+  }
+}
+async function runTaskStream(httpConfig, body, onEvent) {
+  const url = `${httpConfig.baseUrl}/developer/v2/task`;
+  const res = await fetch(url, {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${httpConfig.token}`,
+      "Content-Type": "application/json",
+      "User-Agent": "@mindstudio-ai/agent",
+      Accept: "text/event-stream"
+    },
+    body: JSON.stringify(body)
+  });
+  if (!res.ok) {
+    let message = `${res.status} ${res.statusText}`;
+    let code = "api_error";
+    let details;
+    try {
+      const text = await res.text();
+      try {
+        const errBody = JSON.parse(text);
+        details = errBody;
+        const errMsg = (typeof errBody.error === "string" ? errBody.error : void 0) ?? (typeof errBody.message === "string" ? errBody.message : void 0);
+        if (errMsg) message = errMsg;
+        if (errBody.code) code = errBody.code;
+      } catch {
+        const stripped = text.replace(/<[^>]*>/g, " ").replace(/\s+/g, " ").trim();
+        if (stripped) message = stripped.slice(0, 200);
+      }
+    } catch {
+    }
+    throw new MindStudioError(`[task] ${message}`, code, res.status, details);
+  }
+  const reader = res.body.getReader();
+  const decoder = new TextDecoder();
+  let buffer = "";
+  let result = null;
+  while (true) {
+    const { done, value } = await reader.read();
+    if (done) break;
+    buffer += decoder.decode(value, { stream: true });
+    const lines = buffer.split("\n");
+    buffer = lines.pop() ?? "";
+    for (const line of lines) {
+      if (!line.startsWith("data: ")) continue;
+      try {
+        const event = JSON.parse(line.slice(6));
+        onEvent(event);
+        if (event.type === "error") {
+          throw new MindStudioError(
+            event.error ?? "Task execution failed.",
+            "task_execution_error",
+            500
+          );
+        }
+        if (event.type === "done") {
+          result = {
+            output: event.output,
+            turns: event.turns ?? 0,
+            usage: event.usage ?? {
+              inputTokens: 0,
+              outputTokens: 0,
+              totalBillingCost: 0
+            }
+          };
+        }
+      } catch (err) {
+        if (err instanceof MindStudioError) throw err;
+      }
+    }
+  }
+  if (buffer.startsWith("data: ")) {
+    try {
+      const event = JSON.parse(buffer.slice(6));
+      onEvent(event);
+      if (event.type === "error") {
+        throw new MindStudioError(
+          event.error ?? "Task execution failed.",
+          "task_execution_error",
+          500
+        );
+      }
+      if (event.type === "done") {
+        result = {
+          output: event.output,
+          turns: event.turns ?? 0,
+          usage: event.usage ?? {
+            inputTokens: 0,
+            outputTokens: 0,
+            totalBillingCost: 0
+          }
+        };
+      }
+    } catch (err) {
+      if (err instanceof MindStudioError) throw err;
+    }
+  }
+  if (!result) {
+    throw new MindStudioError(
+      "[task] Stream ended without a done event. The task execution may have been interrupted.",
+      "stream_error",
+      500
+    );
+  }
+  return result;
+}
+
+// src/generated/steps.ts
+function applyStepMethods(AgentClass) {
+  const proto = AgentClass.prototype;
+  proto.activeCampaignAddNote = function(step, options) {
+    return this.executeStep("activeCampaignAddNote", step, options);
+  };
+  proto.activeCampaignCreateContact = function(step, options) {
+    return this.executeStep("activeCampaignCreateContact", step, options);
+  };
+  proto.addSubtitlesToVideo = function(step, options) {
+    return this.executeStep("addSubtitlesToVideo", step, options);
+  };
+  proto.airtableCreateUpdateRecord = function(step, options) {
+    return this.executeStep("airtableCreateUpdateRecord", step, options);
+  };
+  proto.airtableDeleteRecord = function(step, options) {
+    return this.executeStep("airtableDeleteRecord", step, options);
+  };
+  proto.airtableGetRecord = function(step, options) {
+    return this.executeStep("airtableGetRecord", step, options);
+  };
+  proto.airtableGetTableRecords = function(step, options) {
+    return this.executeStep("airtableGetTableRecords", step, options);
+  };
+  proto.analyzeImage = function(step, options) {
+    return this.executeStep("analyzeImage", step, options);
+  };
+  proto.analyzeVideo = function(step, options) {
+    return this.executeStep("analyzeVideo", step, options);
+  };
+  proto.captureThumbnail = function(step, options) {
+    return this.executeStep("captureThumbnail", step, options);
+  };
+  proto.checkAppRole = function(step, options) {
+    return this.executeStep("checkAppRole", step, options);
+  };
+  proto.codaCreateUpdatePage = function(step, options) {
+    return this.executeStep("codaCreateUpdatePage", step, options);
+  };
+  proto.codaCreateUpdateRow = function(step, options) {
+    return this.executeStep("codaCreateUpdateRow", step, options);
+  };
+  proto.codaFindRow = function(step, options) {
+    return this.executeStep("codaFindRow", step, options);
+  };
+  proto.codaGetPage = function(step, options) {
+    return this.executeStep("codaGetPage", step, options);
+  };
+  proto.codaGetTableRows = function(step, options) {
+    return this.executeStep("codaGetTableRows", step, options);
+  };
+  proto.convertPdfToImages = function(step, options) {
+    return this.executeStep("convertPdfToImages", step, options);
+  };
+  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);
+  };
+  proto.createGoogleDoc = function(step, options) {
+    return this.executeStep("createGoogleDoc", step, options);
+  };
+  proto.createGoogleSheet = function(step, options) {
+    return this.executeStep("createGoogleSheet", step, options);
+  };
+  proto.deleteDataSource = function(step, options) {
+    return this.executeStep("deleteDataSource", step, options);
+  };
+  proto.deleteDataSourceDocument = function(step, options) {
+    return this.executeStep("deleteDataSourceDocument", step, options);
+  };
+  proto.deleteGmailEmail = function(step, options) {
+    return this.executeStep("deleteGmailEmail", step, options);
+  };
+  proto.deleteGoogleCalendarEvent = function(step, options) {
+    return this.executeStep("deleteGoogleCalendarEvent", step, options);
+  };
+  proto.deleteGoogleSheetRows = function(step, options) {
+    return this.executeStep("deleteGoogleSheetRows", step, options);
+  };
+  proto.detectChanges = function(step, options) {
+    return this.executeStep("detectChanges", step, options);
+  };
+  proto.detectPII = function(step, options) {
+    return this.executeStep("detectPII", step, options);
+  };
+  proto.discordEditMessage = function(step, options) {
+    return this.executeStep("discordEditMessage", step, options);
+  };
+  proto.discordSendFollowUp = function(step, options) {
+    return this.executeStep("discordSendFollowUp", step, options);
+  };
+  proto.discordSendMessage = function(step, options) {
+    return this.executeStep("discordSendMessage", step, options);
+  };
+  proto.downloadVideo = function(step, options) {
+    return this.executeStep("downloadVideo", step, options);
+  };
+  proto.enhanceImageGenerationPrompt = function(step, options) {
+    return this.executeStep("enhanceImageGenerationPrompt", step, options);
+  };
+  proto.enhanceVideoGenerationPrompt = function(step, options) {
+    return this.executeStep("enhanceVideoGenerationPrompt", step, options);
+  };
+  proto.enrichPerson = function(step, options) {
+    return this.executeStep("enrichPerson", step, options);
+  };
+  proto.extractAudioFromVideo = function(step, options) {
+    return this.executeStep("extractAudioFromVideo", step, options);
+  };
+  proto.extractText = function(step, options) {
+    return this.executeStep("extractText", step, options);
+  };
+  proto.fetchDataSourceDocument = function(step, options) {
+    return this.executeStep("fetchDataSourceDocument", step, options);
+  };
+  proto.fetchGoogleDoc = function(step, options) {
+    return this.executeStep("fetchGoogleDoc", step, options);
+  };
+  proto.fetchGoogleSheet = function(step, options) {
+    return this.executeStep("fetchGoogleSheet", step, options);
+  };
+  proto.fetchSlackChannelHistory = function(step, options) {
+    return this.executeStep("fetchSlackChannelHistory", step, options);
+  };
+  proto.fetchYoutubeCaptions = function(step, options) {
+    return this.executeStep("fetchYoutubeCaptions", step, options);
+  };
+  proto.fetchYoutubeChannel = function(step, options) {
+    return this.executeStep("fetchYoutubeChannel", step, options);
+  };
+  proto.fetchYoutubeComments = function(step, options) {
+    return this.executeStep("fetchYoutubeComments", step, options);
+  };
+  proto.fetchYoutubeVideo = function(step, options) {
+    return this.executeStep("fetchYoutubeVideo", step, options);
+  };
+  proto.generateChart = function(step, options) {
+    return this.executeStep("generateChart", step, options);
+  };
+  proto.generateImage = function(step, options) {
+    return this.executeStep("generateImage", step, options);
+  };
+  proto.generateLipsync = function(step, options) {
+    return this.executeStep("generateLipsync", step, options);
+  };
+  proto.generateMusic = function(step, options) {
+    return this.executeStep("generateMusic", step, options);
+  };
+  proto.generateAsset = function(step, options) {
+    return this.executeStep("generatePdf", step, options);
+  };
+  proto.generateStaticVideoFromImage = function(step, options) {
+    return this.executeStep("generateStaticVideoFromImage", step, options);
+  };
+  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);
+  };
+  proto.getGoogleDriveFile = function(step, options) {
+    return this.executeStep("getGoogleDriveFile", step, options);
+  };
+  proto.getGoogleSheetInfo = function(step, options) {
+    return this.executeStep("getGoogleSheetInfo", step, options);
+  };
+  proto.getMediaMetadata = function(step, options) {
+    return this.executeStep("getMediaMetadata", step, options);
+  };
+  proto.httpRequest = function(step, options) {
+    return this.executeStep("httpRequest", step, options);
+  };
+  proto.hubspotCreateCompany = function(step, options) {
+    return this.executeStep("hubspotCreateCompany", step, options);
+  };
+  proto.hubspotCreateContact = function(step, options) {
+    return this.executeStep("hubspotCreateContact", step, options);
+  };
+  proto.hubspotGetCompany = function(step, options) {
+    return this.executeStep("hubspotGetCompany", step, options);
+  };
+  proto.hubspotGetContact = function(step, options) {
+    return this.executeStep("hubspotGetContact", step, options);
+  };
+  proto.hunterApiCompanyEnrichment = function(step, options) {
+    return this.executeStep("hunterApiCompanyEnrichment", step, options);
+  };
+  proto.hunterApiDomainSearch = function(step, options) {
+    return this.executeStep("hunterApiDomainSearch", step, options);
+  };
+  proto.hunterApiEmailFinder = function(step, options) {
+    return this.executeStep("hunterApiEmailFinder", step, options);
+  };
+  proto.hunterApiEmailVerification = function(step, options) {
+    return this.executeStep("hunterApiEmailVerification", step, options);
+  };
+  proto.hunterApiPersonEnrichment = function(step, options) {
+    return this.executeStep("hunterApiPersonEnrichment", step, options);
+  };
+  proto.imageFaceSwap = function(step, options) {
+    return this.executeStep("imageFaceSwap", step, options);
+  };
+  proto.imageRemoveWatermark = function(step, options) {
+    return this.executeStep("imageRemoveWatermark", step, options);
+  };
+  proto.insertVideoClips = function(step, options) {
+    return this.executeStep("insertVideoClips", step, options);
+  };
+  proto.listDataSources = function(step, options) {
+    return this.executeStep("listDataSources", step, options);
+  };
+  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);
+  };
+  proto.makeDotComRunScenario = function(step, options) {
+    return this.executeStep("makeDotComRunScenario", step, options);
+  };
+  proto.mergeAudio = function(step, options) {
+    return this.executeStep("mergeAudio", step, options);
+  };
+  proto.mergeVideos = function(step, options) {
+    return this.executeStep("mergeVideos", step, options);
+  };
+  proto.mixAudioIntoVideo = function(step, options) {
+    return this.executeStep("mixAudioIntoVideo", step, options);
+  };
+  proto.muteVideo = function(step, options) {
+    return this.executeStep("muteVideo", step, options);
+  };
+  proto.n8nRunNode = function(step, options) {
+    return this.executeStep("n8nRunNode", step, options);
+  };
+  proto.notionCreatePage = function(step, options) {
+    return this.executeStep("notionCreatePage", step, options);
+  };
+  proto.notionUpdatePage = function(step, options) {
+    return this.executeStep("notionUpdatePage", step, options);
+  };
+  proto.peopleSearch = function(step, options) {
+    return this.executeStep("peopleSearch", step, options);
+  };
+  proto.postToLinkedIn = function(step, options) {
+    return this.executeStep("postToLinkedIn", step, options);
+  };
+  proto.postToSlackChannel = function(step, options) {
+    return this.executeStep("postToSlackChannel", step, options);
+  };
+  proto.postToX = function(step, options) {
+    return this.executeStep("postToX", step, options);
+  };
+  proto.postToZapier = function(step, options) {
+    return this.executeStep("postToZapier", step, options);
+  };
+  proto.queryAppDatabase = function(step, options) {
+    return this.executeStep("queryAppDatabase", step, options);
+  };
+  proto.queryDataSource = function(step, options) {
+    return this.executeStep("queryDataSource", step, options);
+  };
+  proto.queryExternalDatabase = function(step, options) {
+    return this.executeStep("queryExternalDatabase", step, options);
+  };
+  proto.redactPII = function(step, options) {
+    return this.executeStep("redactPII", step, options);
+  };
+  proto.removeBackgroundFromImage = function(step, options) {
+    return this.executeStep("removeBackgroundFromImage", step, options);
+  };
+  proto.replyToGmailEmail = function(step, options) {
+    return this.executeStep("replyToGmailEmail", step, options);
+  };
+  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);
+  };
+  proto.scrapeFacebookPage = function(step, options) {
+    return this.executeStep("scrapeFacebookPage", step, options);
+  };
+  proto.scrapeFacebookPosts = function(step, options) {
+    return this.executeStep("scrapeFacebookPosts", step, options);
+  };
+  proto.scrapeInstagramComments = function(step, options) {
+    return this.executeStep("scrapeInstagramComments", step, options);
+  };
+  proto.scrapeInstagramMentions = function(step, options) {
+    return this.executeStep("scrapeInstagramMentions", step, options);
+  };
+  proto.scrapeInstagramPosts = function(step, options) {
+    return this.executeStep("scrapeInstagramPosts", step, options);
+  };
+  proto.scrapeInstagramProfile = function(step, options) {
+    return this.executeStep("scrapeInstagramProfile", step, options);
+  };
+  proto.scrapeInstagramReels = function(step, options) {
+    return this.executeStep("scrapeInstagramReels", step, options);
+  };
+  proto.scrapeLinkedInCompany = function(step, options) {
+    return this.executeStep("scrapeLinkedInCompany", step, options);
+  };
+  proto.scrapeLinkedInProfile = function(step, options) {
+    return this.executeStep("scrapeLinkedInProfile", step, options);
+  };
+  proto.scrapeMetaThreadsProfile = function(step, options) {
+    return this.executeStep("scrapeMetaThreadsProfile", step, options);
+  };
+  proto.scrapeUrl = function(step, options) {
+    return this.executeStep("scrapeUrl", step, options);
+  };
+  proto.scrapeXPost = function(step, options) {
+    return this.executeStep("scrapeXPost", step, options);
+  };
+  proto.scrapeXProfile = function(step, options) {
+    return this.executeStep("scrapeXProfile", step, options);
+  };
+  proto.screenshotUrl = function(step, options) {
+    return this.executeStep("screenshotUrl", step, options);
+  };
+  proto.searchGmailEmails = function(step, options) {
+    return this.executeStep("searchGmailEmails", step, options);
+  };
+  proto.searchGoogle = function(step, options) {
+    return this.executeStep("searchGoogle", step, options);
+  };
+  proto.searchGoogleCalendarEvents = function(step, options) {
+    return this.executeStep("searchGoogleCalendarEvents", step, options);
+  };
+  proto.searchGoogleDrive = function(step, options) {
+    return this.executeStep("searchGoogleDrive", step, options);
+  };
+  proto.searchGoogleImages = function(step, options) {
+    return this.executeStep("searchGoogleImages", step, options);
+  };
+  proto.searchGoogleNews = function(step, options) {
+    return this.executeStep("searchGoogleNews", step, options);
+  };
+  proto.searchGoogleTrends = function(step, options) {
+    return this.executeStep("searchGoogleTrends", step, options);
+  };
+  proto.searchPerplexity = function(step, options) {
+    return this.executeStep("searchPerplexity", step, options);
+  };
+  proto.searchXPosts = function(step, options) {
+    return this.executeStep("searchXPosts", step, options);
+  };
+  proto.searchYoutube = function(step, options) {
+    return this.executeStep("searchYoutube", step, options);
+  };
+  proto.searchYoutubeTrends = function(step, options) {
+    return this.executeStep("searchYoutubeTrends", step, options);
+  };
+  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.sendSlackDirectMessage = function(step, options) {
+    return this.executeStep("sendSlackDirectMessage", 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);
+  };
+  proto.setVariable = function(step, options) {
+    return this.executeStep("setVariable", step, options);
+  };
+  proto.telegramEditMessage = function(step, options) {
+    return this.executeStep("telegramEditMessage", step, options);
+  };
+  proto.telegramReplyToMessage = function(step, options) {
+    return this.executeStep("telegramReplyToMessage", step, options);
+  };
+  proto.telegramSendAudio = function(step, options) {
+    return this.executeStep("telegramSendAudio", step, options);
+  };
+  proto.telegramSendFile = function(step, options) {
+    return this.executeStep("telegramSendFile", step, options);
+  };
+  proto.telegramSendImage = function(step, options) {
+    return this.executeStep("telegramSendImage", step, options);
+  };
+  proto.telegramSendMessage = function(step, options) {
+    return this.executeStep("telegramSendMessage", step, options);
+  };
+  proto.telegramSendVideo = function(step, options) {
+    return this.executeStep("telegramSendVideo", step, options);
+  };
+  proto.telegramSetTyping = function(step, options) {
+    return this.executeStep("telegramSetTyping", step, options);
+  };
+  proto.textToSpeech = function(step, options) {
+    return this.executeStep("textToSpeech", step, options);
+  };
+  proto.transcribeAudio = function(step, options) {
+    return this.executeStep("transcribeAudio", step, options);
+  };
+  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);
+  };
+  proto.updateGoogleDoc = function(step, options) {
+    return this.executeStep("updateGoogleDoc", step, options);
+  };
+  proto.updateGoogleSheet = function(step, options) {
+    return this.executeStep("updateGoogleSheet", step, options);
+  };
+  proto.uploadDataSourceDocument = function(step, options) {
+    return this.executeStep("uploadDataSourceDocument", step, options);
+  };
+  proto.upscaleImage = function(step, options) {
+    return this.executeStep("upscaleImage", step, options);
+  };
+  proto.upscaleVideo = function(step, options) {
+    return this.executeStep("upscaleVideo", step, options);
+  };
+  proto.generateText = function(step, options) {
+    return this.executeStep("userMessage", step, options);
+  };
+  proto.videoFaceSwap = function(step, options) {
+    return this.executeStep("videoFaceSwap", step, options);
+  };
+  proto.videoRemoveBackground = function(step, options) {
+    return this.executeStep("videoRemoveBackground", step, options);
+  };
+  proto.videoRemoveWatermark = function(step, options) {
+    return this.executeStep("videoRemoveWatermark", step, options);
+  };
+  proto.watermarkImage = function(step, options) {
+    return this.executeStep("watermarkImage", step, options);
+  };
+  proto.watermarkVideo = function(step, options) {
+    return this.executeStep("watermarkVideo", step, options);
+  };
+}
+
 // src/client.ts
 var DEFAULT_BASE_URL = "https://v1.mindstudio-api.com";
 var DEFAULT_MAX_RETRIES = 3;
@@ -3690,52 +3871,115 @@ var MindStudioAgent = class {
    */
   async executeStepBatch(steps, options) {
     const threadId = options?.threadId ?? (this._reuseThreadId && !getRequestContext() ? this._threadId : void 0);
-    const { data } = await request(this._httpConfig, "POST", "/steps/execute-batch", {
-      steps: steps.map((s) => ({ ...s, stepType: resolveStepType(s.stepType) })),
+    const { data: asyncData } = await request(this._currentHttpConfig, "POST", "/steps/execute-batch-async", {
+      steps: steps.map((s) => ({ ...s, stepType: resolveStepType2(s.stepType) })),
       ...options?.appId != null && { appId: options.appId },
       ...threadId != null && { threadId }
     });
-    const results = await Promise.all(
-      data.results.map(async (r) => {
-        if (r.output != null) {
-          return {
-            stepType: r.stepType,
-            output: r.output,
-            billingCost: r.billingCost,
-            error: r.error
-          };
+    const pollUrl = `${this._currentHttpConfig.baseUrl}/developer/v2/steps/execute-batch-async/poll/${asyncData.batchToken}`;
+    let pollDelay = 300;
+    while (true) {
+      await sleep3(pollDelay);
+      pollDelay = Math.min(pollDelay * 1.5, 3e3);
+      const res = await fetch(pollUrl, {
+        headers: { "User-Agent": "@mindstudio-ai/agent" }
+      });
+      if (res.status === 404) {
+        throw new MindStudioError(
+          "Batch poll token not found or expired.",
+          "poll_token_expired",
+          404
+        );
+      }
+      if (!res.ok) {
+        const errorBody = await res.json().catch(() => ({}));
+        throw new MindStudioError(
+          errorBody.message ?? errorBody.error ?? `Batch poll failed: ${res.status} ${res.statusText}`,
+          errorBody.code ?? "poll_error",
+          res.status,
+          errorBody
+        );
+      }
+      const poll = await res.json();
+      if (poll.status === "pending") {
+        if (options?.onProgress && poll.totalSteps != null && poll.completedSteps != null) {
+          options.onProgress(poll.completedSteps, poll.totalSteps);
         }
-        if (r.outputUrl) {
-          const res = await fetch(r.outputUrl);
-          if (!res.ok) {
+        continue;
+      }
+      if (poll.status === "error") {
+        throw new MindStudioError(
+          poll.error ?? "Batch execution failed.",
+          "batch_execution_error",
+          500
+        );
+      }
+      const results = await Promise.all(
+        poll.results.map(async (r) => {
+          if (r.output != null) {
+            return {
+              stepType: r.stepType,
+              output: r.output,
+              billingCost: r.billingCost,
+              error: r.error
+            };
+          }
+          if (r.outputUrl) {
+            const s3Res = await fetch(r.outputUrl);
+            if (!s3Res.ok) {
+              return {
+                stepType: r.stepType,
+                error: `Failed to fetch output from S3: ${s3Res.status} ${s3Res.statusText}`
+              };
+            }
+            const envelope = await s3Res.json();
             return {
               stepType: r.stepType,
-              error: `Failed to fetch output from S3: ${res.status} ${res.statusText}`
+              output: envelope.value,
+              billingCost: r.billingCost
             };
           }
-          const envelope = await res.json();
           return {
             stepType: r.stepType,
-            output: envelope.value,
-            billingCost: r.billingCost
+            billingCost: r.billingCost,
+            error: r.error
           };
-        }
-        return {
-          stepType: r.stepType,
-          billingCost: r.billingCost,
-          error: r.error
-        };
-      })
-    );
-    if (this._reuseThreadId && data.threadId && !getRequestContext()) {
-      this._threadId = data.threadId;
+        })
+      );
+      const resultThreadId = poll.threadId ?? asyncData.threadId;
+      if (this._reuseThreadId && resultThreadId && !getRequestContext()) {
+        this._threadId = resultThreadId;
+      }
+      return {
+        results,
+        totalBillingCost: poll.totalBillingCost,
+        appId: poll.appId,
+        threadId: resultThreadId
+      };
     }
-    return {
-      results,
-      totalBillingCost: data.totalBillingCost,
-      appId: data.appId,
-      threadId: data.threadId
-    };
+  }
+  /**
+   * Run a task agent — a multi-step tool-use loop that composes SDK actions
+   * to produce structured output. The model receives the prompt and tools,
+   * calls actions as needed, and returns JSON matching the output example.
+   *
+   * ```ts
+   * const result = await agent.runTask<{ name: string; url: string }>({
+   *   prompt: 'Find canonical info for this restaurant.',
+   *   input: { restaurantName: 'Tartine Bakery SF' },
+   *   tools: ['searchGoogle', 'fetchUrl'],
+   *   structuredOutputExample: JSON.stringify({ name: 'Tartine Bakery', url: 'https://tartinebakery.com' }),
+   *   model: 'claude-4-6-sonnet',
+   * });
+   * console.log(result.output.name); // 'Tartine Bakery'
+   * ```
+   */
+  async runTask(options) {
+    const body = buildTaskRequestBody(options);
+    if (options.onEvent) {
+      return runTaskStream(this._currentHttpConfig, body, options.onEvent);
+    }
+    return runTaskPoll(this._currentHttpConfig, body);
   }
   /**
    * Get the authenticated user's identity and organization info.
@@ -3799,7 +4043,7 @@ var MindStudioAgent = class {
     const token = data.callbackToken;
     const pollUrl = `${this._currentHttpConfig.baseUrl}/developer/v2/agents/run/poll/${token}`;
     while (true) {
-      await sleep2(pollInterval);
+      await sleep3(pollInterval);
       const res = await fetch(pollUrl, {
         headers: { "User-Agent": "@mindstudio-ai/agent" }
       });
@@ -3924,7 +4168,7 @@ var MindStudioAgent = class {
   /** Estimate the cost of executing an action before running it. */
   async estimateStepCost(stepType, step, options) {
     const { data } = await request(this._httpConfig, "POST", "/helpers/step-cost-estimate", {
-      step: { type: resolveStepType(stepType), ...step },
+      step: { type: resolveStepType2(stepType), ...step },
       ...options
     });
     return data;
@@ -4410,11 +4654,11 @@ var MindStudioAgent = class {
     return { url: data.url };
   }
 };
-function sleep2(ms) {
+function sleep3(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
 applyStepMethods(MindStudioAgent);
-function resolveStepType(name) {
+function resolveStepType2(name) {
   const meta = stepMetadata[name];
   return meta ? meta.stepType : name;
 }