@mindstudio-ai/agent 0.1.1 → 0.1.4

package/README.md

@@ -8,11 +8,31 @@ Generate text, images, video, and audio. Scrape the web. Search Google. Post to
 
 ## Install
 
+### CLI / MCP (standalone binary)
+
+No dependencies required — downloads a standalone binary:
+
+**macOS / Linux:**
+```bash
+curl -fsSL https://msagent.ai/install.sh | bash
+mindstudio login
+```
+
+**Windows (PowerShell):**
+```
+irm https://msagent.ai/install.ps1 | iex
+mindstudio login
+```
+
+To update, run the same command again. To uninstall, `rm /usr/local/bin/mindstudio` (macOS/Linux) or delete `%USERPROFILE%\.mindstudio\bin\mindstudio.exe` (Windows).
+
+### SDK (npm)
+
 ```bash
 npm install @mindstudio-ai/agent
 ```
 
-Requires Node.js 18+.
+Requires Node.js 18+. Also installs the CLI as `mindstudio`.
 
 ## Quick start
 
@@ -77,6 +97,22 @@ npx @mindstudio-ai/agent generate-text --message "Hello"
 
 Add to your MCP client config (Claude Code, Cursor, VS Code, etc.):
 
+**With standalone binary** (recommended — faster startup, no Node required):
+```json
+{
+  "mcpServers": {
+    "mindstudio": {
+      "command": "mindstudio",
+      "args": ["mcp"],
+      "env": {
+        "MINDSTUDIO_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+**With npx** (no install needed):
 ```json
 {
   "mcpServers": {
@@ -454,14 +490,14 @@ Start manually:
 mindstudio mcp
 ```
 
-Or configure your MCP client:
+Or configure your MCP client (standalone binary or npx):
 
 ```json
 {
   "mcpServers": {
     "mindstudio": {
-      "command": "npx",
-      "args": ["-y", "@mindstudio-ai/agent", "mcp"],
+      "command": "mindstudio",
+      "args": ["mcp"],
       "env": {
         "MINDSTUDIO_API_KEY": "your-api-key"
       }

package/dist/cli.js

@@ -1840,6 +1840,26 @@ function applyHelperMethods(AgentClass) {
   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"() {
@@ -2041,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");
 }
@@ -2093,8 +2115,9 @@ async function startMcpServer(options) {
           capabilities: { tools: {} },
           serverInfo: {
             name: "mindstudio-agent",
-            version: "0.1.1"
-          }
+            version: "0.1.4"
+          },
+          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.\n\nImportant:\n- AI-powered steps (text generation, image generation, video, audio, etc.) cost money. Before running these, call `estimateStepCost` and confirm with the user before proceeding \u2014 unless they've explicitly told you to go ahead.\n- Not all agents from `listAgents` are configured for API use. Do not try to run an agent just because it appears in the list \u2014 it will likely fail. Only run agents the user specifically asks you to run."
         });
         break;
       case "notifications/initialized":
@@ -2153,6 +2176,26 @@ async function startMcpServer(options) {
                 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") {
@@ -2207,12 +2250,28 @@ async function startMcpServer(options) {
     }
   }
 }
-var MCP_PROTOCOL_VERSION, HELPER_DESCRIPTIONS, 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.",
@@ -2223,13 +2282,16 @@ var init_mcp = __esm({
       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. Use this first to discover what steps and helpers are available, then call a specific method by name.",
+        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: {} }
       },
       {
@@ -2350,6 +2412,48 @@ var init_mcp = __esm({
           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.",
@@ -2389,12 +2493,15 @@ 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] [--summary]   List available methods (--summary for compact JSON)
@@ -2495,7 +2602,9 @@ var HELPER_NAMES = /* @__PURE__ */ new Set([
   "getConnector",
   "getConnectorAction",
   "listConnections",
-  "estimateStepCost"
+  "estimateStepCost",
+  "changeName",
+  "changeProfilePicture"
 ]);
 function resolveMethodOrFail(name, metadataKeys) {
   if (metadataKeys.has(name)) return name;
@@ -2530,6 +2639,8 @@ var HELPER_DESCRIPTIONS2 = {
   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."
 };
@@ -2546,9 +2657,7 @@ function buildSummary(stepMetadata2) {
 async function cmdList(asJson, asSummary) {
   const { stepMetadata: stepMetadata2 } = await Promise.resolve().then(() => (init_metadata(), metadata_exports));
   if (asSummary) {
-    process.stdout.write(
-      JSON.stringify(buildSummary(stepMetadata2)) + "\n"
-    );
+    process.stdout.write(JSON.stringify(buildSummary(stepMetadata2)) + "\n");
   } else if (asJson) {
     const entries = Object.entries(stepMetadata2).map(([name, meta]) => ({
       method: camelToKebab(name),
@@ -2579,15 +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[] }" },
-      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[] }" }
+      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(`
@@ -2646,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) {
@@ -2672,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") {
@@ -2695,6 +2850,12 @@ async function cmdExec(method, input, options) {
         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];
@@ -2749,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}
+`);
     }
   }
 }
@@ -2786,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`,
@@ -2809,7 +3003,7 @@ function isNewerVersion(current, latest) {
   return false;
 }
 async function checkForUpdate() {
-  const currentVersion = "0.1.1";
+  const currentVersion = "0.1.4";
   if (!currentVersion) return null;
   try {
     const { loadConfig: loadConfig2, saveConfig: saveConfig2 } = await Promise.resolve().then(() => (init_config(), config_exports));
@@ -2838,7 +3032,7 @@ async function checkForUpdate() {
   }
 }
 function printUpdateNotice(latestVersion) {
-  const currentVersion = "0.1.1";
+  const currentVersion = "0.1.4";
   process.stderr.write(
     `
   ${ansi.cyanBright("Update available")} ${ansi.gray(currentVersion + " \u2192")} ${ansi.cyanBold(latestVersion)}
@@ -2912,9 +3106,9 @@ async function cmdLogin(options) {
   process.stderr.write("\n");
   printLogo();
   process.stderr.write("\n");
-  const ver = "0.1.1";
+  const ver = "0.1.4";
   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(
@@ -2931,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",
@@ -2980,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) {
@@ -3015,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();
@@ -3149,9 +3337,24 @@ async function main() {
       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);
@@ -3174,10 +3377,7 @@ async function main() {
       return;
     }
     if (command === "list") {
-      await cmdList(
-        values.json,
-        values.summary
-      );
+      await cmdList(values.json, values.summary);
       return;
     }
     if (command === "agents") {
@@ -3191,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];
@@ -3238,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({
@@ -3255,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);

package/dist/index.d.ts

@@ -6580,6 +6580,8 @@ interface StepCostEstimateEntry {
     estimatedCost?: number;
     /** Number of billable units. */
     quantity?: number;
+    /** Estimated latency based on recent global model metrics. null when no metrics are available. */
+    latency?: unknown;
 }
 /** Supported model type categories for filtering. */
 type ModelType = "llm_chat" | "image_generation" | "video_generation" | "video_analysis" | "text_to_speech" | "vision" | "transcription";
@@ -6665,6 +6667,38 @@ interface HelperMethods {
         costType?: string;
         estimates?: StepCostEstimateEntry[];
     }>;
+    /**
+     * Update the display name of the authenticated agent.
+     *
+     * Useful for agents to set their own name after connecting.
+     *
+     * @param displayName - The new display name.
+     */
+    changeName(displayName: string): Promise<void>;
+    /**
+     * Update the profile picture of the authenticated agent.
+     *
+     * Useful for agents to set their own avatar after connecting.
+     *
+     * @param profilePictureUrl - URL of the new profile picture.
+     */
+    changeProfilePicture(profilePictureUrl: string): Promise<void>;
+    /**
+     * Upload a file to the MindStudio CDN.
+     *
+     * Gets a signed upload URL, PUTs the file content, and returns the permanent public URL.
+     *
+     * @param content - File content as a Buffer or Uint8Array.
+     * @param options - Upload options.
+     * @param options.extension - File extension without the dot (e.g. "png", "jpg", "mp4").
+     * @param options.type - MIME type of the file (e.g. "image/png"). Determines which CDN subdomain is used.
+     */
+    uploadFile(content: Buffer | Uint8Array, options: {
+        extension: string;
+        type?: string;
+    }): Promise<{
+        url: string;
+    }>;
 }
 
 /**

package/dist/index.js

@@ -640,6 +640,26 @@ function applyHelperMethods(AgentClass) {
   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