@mindstudio-ai/agent 0.1.1 → 0.1.3

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.3"
+          },
+          instructions: "Welcome to MindStudio \u2014 a platform with 200+ AI models, 850+ third-party integrations, and pre-built agents.\n\nGetting started:\n1. Call `listAgents` to verify your connection and see available agents.\n2. Call `changeName` to set your display name \u2014 use your name or whatever your user calls you. This is how you'll appear in MindStudio request logs.\n3. If you have a profile picture or icon, call `uploadFile` to upload it, then `changeProfilePicture` with the returned URL. This helps users identify your requests in their logs.\n4. Call `listSteps` to discover all available step methods and helpers.\n\nThen use the tools to generate text, images, video, audio, search the web, work with data sources, run agents, and more."
         });
         break;
       case "notifications/initialized":
@@ -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.3";
   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.3";
   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.3";
   process.stderr.write(
-    `  ${ansi.bold("MindStudio")} ${ansi.gray("CLI")}${ver ? " " + ansi.gray("v" + ver) : ""}
+    `  ${ansi.bold("MindStudio Agent")} ${ver ? " " + ansi.gray("v" + ver) : ""}
 `
   );
   process.stderr.write(
@@ -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