@mindstudio-ai/agent 0.1.3 → 0.1.5

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,22 @@ var MindStudioAgent = class {
       $billingEvents: billingEvents != null ? JSON.parse(billingEvents) : void 0
     };
   }
+  /**
+   * 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 +773,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)