@mindstudio-ai/agent 0.1.4 → 0.1.6

package/dist/index.js

@@ -610,58 +610,6 @@ function applyStepMethods(AgentClass) {
   };
 }
 
-// src/generated/helpers.ts
-function applyHelperMethods(AgentClass) {
-  const proto = AgentClass.prototype;
-  proto.listModels = function() {
-    return this._request("GET", "/helpers/models").then((r) => r.data);
-  };
-  proto.listModelsByType = function(modelType) {
-    return this._request("GET", `/helpers/models/${modelType}`).then((r) => r.data);
-  };
-  proto.listModelsSummary = function() {
-    return this._request("GET", "/helpers/models-summary").then((r) => r.data);
-  };
-  proto.listModelsSummaryByType = function(modelType) {
-    return this._request("GET", `/helpers/models-summary/${modelType}`).then((r) => r.data);
-  };
-  proto.listConnectors = function() {
-    return this._request("GET", "/helpers/connectors").then((r) => r.data);
-  };
-  proto.getConnector = function(serviceId) {
-    return this._request("GET", `/helpers/connectors/${serviceId}`).then((r) => r.data);
-  };
-  proto.getConnectorAction = function(serviceId, actionId) {
-    return this._request("GET", `/helpers/connectors/${serviceId}/${actionId}`).then((r) => r.data);
-  };
-  proto.listConnections = function() {
-    return this._request("GET", "/helpers/connections").then((r) => r.data);
-  };
-  proto.estimateStepCost = function(stepType, step, options) {
-    return this._request("POST", "/helpers/step-cost-estimate", { step: { type: stepType, ...step }, ...options }).then((r) => r.data);
-  };
-  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 };
-  };
-}
-
 // src/client.ts
 var DEFAULT_BASE_URL = "https://v1.mindstudio-api.com";
 var DEFAULT_MAX_RETRIES = 3;
@@ -733,6 +681,85 @@ var MindStudioAgent = class {
       $billingEvents: billingEvents != null ? JSON.parse(billingEvents) : void 0
     };
   }
+  /**
+   * Execute multiple steps in parallel in a single request.
+   *
+   * All steps run in parallel on the server. Results are returned in the same
+   * order as the input. Individual step failures do not affect other steps —
+   * partial success is possible.
+   *
+   * ```ts
+   * const { results } = await agent.executeStepBatch([
+   *   { stepType: 'generateImage', step: { prompt: 'a sunset' } },
+   *   { stepType: 'textToSpeech', step: { text: 'Hello world' } },
+   * ]);
+   * ```
+   */
+  async executeStepBatch(steps, options) {
+    const threadId = options?.threadId ?? (this._reuseThreadId ? this._threadId : void 0);
+    const { data } = await request(this._httpConfig, "POST", "/steps/execute-batch", {
+      steps,
+      ...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
+          };
+        }
+        if (r.outputUrl) {
+          const res = await fetch(r.outputUrl);
+          if (!res.ok) {
+            return {
+              stepType: r.stepType,
+              error: `Failed to fetch output from S3: ${res.status} ${res.statusText}`
+            };
+          }
+          const envelope = await res.json();
+          return {
+            stepType: r.stepType,
+            output: envelope.value,
+            billingCost: r.billingCost
+          };
+        }
+        return {
+          stepType: r.stepType,
+          billingCost: r.billingCost,
+          error: r.error
+        };
+      })
+    );
+    if (this._reuseThreadId && data.threadId) {
+      this._threadId = data.threadId;
+    }
+    return {
+      results,
+      totalBillingCost: data.totalBillingCost,
+      appId: data.appId,
+      threadId: data.threadId
+    };
+  }
+  /**
+   * Get the authenticated user's identity and organization info.
+   *
+   * ```ts
+   * const info = await agent.getUserInfo();
+   * console.log(info.displayName, info.organizationName);
+   * ```
+   */
+  async getUserInfo() {
+    const { data } = await request(
+      this._httpConfig,
+      "GET",
+      "/account/userinfo"
+    );
+    return data;
+  }
   /**
    * List all pre-built agents in the organization.
    *
@@ -809,16 +836,158 @@ var MindStudioAgent = class {
       return poll.result;
     }
   }
-  /** @internal Used by generated helper methods. */
+  /** @internal Used by generated action methods. */
   _request(method, path, body) {
     return request(this._httpConfig, method, path, body);
   }
+  // -------------------------------------------------------------------------
+  // Helper methods — models
+  // -------------------------------------------------------------------------
+  /** List all available AI models. */
+  async listModels() {
+    const { data } = await request(
+      this._httpConfig,
+      "GET",
+      "/helpers/models"
+    );
+    return data;
+  }
+  /** List AI models filtered by type. */
+  async listModelsByType(modelType) {
+    const { data } = await request(
+      this._httpConfig,
+      "GET",
+      `/helpers/models/${modelType}`
+    );
+    return data;
+  }
+  /** List all available AI models (summary). Returns only id, name, type, and tags. */
+  async listModelsSummary() {
+    const { data } = await request(
+      this._httpConfig,
+      "GET",
+      "/helpers/models-summary"
+    );
+    return data;
+  }
+  /** List AI models (summary) filtered by type. */
+  async listModelsSummaryByType(modelType) {
+    const { data } = await request(
+      this._httpConfig,
+      "GET",
+      `/helpers/models-summary/${modelType}`
+    );
+    return data;
+  }
+  // -------------------------------------------------------------------------
+  // Helper methods — OAuth connectors & connections
+  // -------------------------------------------------------------------------
+  /**
+   * List available OAuth connector services (Slack, Google, HubSpot, etc.).
+   *
+   * These are third-party integrations from the MindStudio Connector Registry.
+   * For most tasks, use actions directly instead.
+   */
+  async listConnectors() {
+    const { data } = await request(
+      this._httpConfig,
+      "GET",
+      "/helpers/connectors"
+    );
+    return data;
+  }
+  /** Get details for a single OAuth connector service. */
+  async getConnector(serviceId) {
+    const { data } = await request(
+      this._httpConfig,
+      "GET",
+      `/helpers/connectors/${serviceId}`
+    );
+    return data;
+  }
+  /** Get the full configuration for an OAuth connector action, including input fields. */
+  async getConnectorAction(serviceId, actionId) {
+    const { data } = await request(
+      this._httpConfig,
+      "GET",
+      `/helpers/connectors/${serviceId}/${actionId}`
+    );
+    return data;
+  }
+  /** List OAuth connections for the organization. These are authenticated third-party service links. */
+  async listConnections() {
+    const { data } = await request(
+      this._httpConfig,
+      "GET",
+      "/helpers/connections"
+    );
+    return data;
+  }
+  // -------------------------------------------------------------------------
+  // Helper methods — cost estimation
+  // -------------------------------------------------------------------------
+  /** 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: stepType, ...step },
+      ...options
+    });
+    return data;
+  }
+  // -------------------------------------------------------------------------
+  // Account methods
+  // -------------------------------------------------------------------------
+  /** Update the display name of the authenticated user/agent. */
+  async changeName(displayName) {
+    await request(this._httpConfig, "POST", "/account/change-name", {
+      name: displayName
+    });
+  }
+  /** Update the profile picture of the authenticated user/agent. */
+  async changeProfilePicture(url) {
+    await request(this._httpConfig, "POST", "/account/change-profile-picture", {
+      url
+    });
+  }
+  /**
+   * Upload a file to the MindStudio CDN.
+   *
+   * Gets a signed upload URL, PUTs the file content, and returns the
+   * permanent public URL.
+   */
+  async uploadFile(content, options) {
+    const { data } = await request(
+      this._httpConfig,
+      "POST",
+      "/account/upload",
+      {
+        extension: options.extension,
+        ...options.type != null && { type: options.type }
+      }
+    );
+    const buf = content.buffer.slice(
+      content.byteOffset,
+      content.byteOffset + content.byteLength
+    );
+    const res = await fetch(data.uploadUrl, {
+      method: "PUT",
+      body: buf,
+      headers: options.type ? { "Content-Type": options.type } : {}
+    });
+    if (!res.ok) {
+      throw new MindStudioError(
+        `Upload failed: ${res.status} ${res.statusText}`,
+        "upload_error",
+        res.status
+      );
+    }
+    return { url: data.url };
+  }
 };
 function sleep2(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
 applyStepMethods(MindStudioAgent);
-applyHelperMethods(MindStudioAgent);
 function resolveToken(provided, config) {
   if (provided) return { token: provided, authType: "apiKey" };
   if (process.env.MINDSTUDIO_API_KEY)
@@ -1665,8 +1834,8 @@ var stepMetadata = {
   "postToX": {
     stepType: "postToX",
     description: "Create a post on X (Twitter) from the connected account.",
-    usageNotes: "- Requires an X OAuth connection (connectionId).\n- Posts are plain text. Maximum 280 characters.",
-    inputSchema: { "type": "object", "properties": { "text": { "type": "string", "description": "The text content of the post (max 280 characters)" }, "connectionId": { "type": "string", "description": "X (Twitter) OAuth connection ID" } }, "required": ["text"] },
+    usageNotes: "- Requires an X OAuth connection (connectionId).\n- Maximum 280 characters of text.\n- Optionally attach up to 4 media items (images, GIFs, or videos) via mediaUrls.\n- Media URLs must be publicly accessible. The service fetches and uploads them to X.\n- Supported formats: JPEG, PNG, GIF, WEBP, MP4. Images up to 5MB, videos up to 512MB.",
+    inputSchema: { "type": "object", "properties": { "text": { "type": "string", "description": "The text content of the post (max 280 characters)" }, "connectionId": { "type": "string", "description": "X (Twitter) OAuth connection ID" }, "mediaUrls": { "type": "array", "items": { "type": "string" }, "description": "Up to 4 URLs of images, GIFs, or videos to attach to the post" } }, "required": ["text"] },
     outputSchema: { "description": "This step does not produce output data." }
   },
   "postToZapier": {