@mindstudio-ai/agent 0.1.68 → 0.1.69

package/dist/cli.js

@@ -5477,6 +5477,8 @@ function buildReferenceDocs(data) {
 
   Task agents: For multi-step tasks requiring autonomous tool use, use \`runTask()\`. Provide a prompt, input, SDK action names as tools (with optional default overrides), a \`structuredOutputExample\`, and a model. The platform runs a tool-use loop and returns structured output. Tools can include any SDK action \u2014 e.g. \`['searchGoogle', 'fetchUrl', { method: 'generateImage', defaults: { imageModelOverride: { model: 'seedream-4.5' } } }]\`. Supports SSE streaming via \`onEvent\` callback.
 
+  Uploading files / getting a hosted URL: There are TWO ways to upload a file to the MindStudio CDN, depending on context. (1) From app backend code, call \`await mindstudio.uploadFile(bytes, { extension: 'png', type?: 'image/png' })\` \u2192 returns \`{ url }\` (a permanent public URL); \`bytes\` is a \`Buffer\`/\`Uint8Array\`, so read/fetch the content first. (2) From the terminal \u2014 e.g. you generated an icon or asset locally and just need its URL \u2014 run \`mindstudio upload <filepath>\` (alias: \`mindstudio upload-file\`). It prints the public URL to stdout. IMPORTANT: to host a one-off local file, use the CLI command directly \u2014 do NOT write a throwaway app method that calls \`uploadFile\` just to trigger it. The CLI does this in one step. More generally: some SDK capabilities are exposed as \`mindstudio\` CLI commands (upload, list-actions, run-agent, exec, batch, \u2026), not only as code \u2014 reach for the CLI for one-off operations instead of writing and running code.
+
   Reporting bugs / ideas (\`reportIssue\`): For building an in-app "Report a bug" or feedback feature, use \`mindstudio.reportIssue({ title, body?, kind?, reporter? })\` (also importable directly as \`reportIssue\`). It files an issue into the app's issue tracker \u2014 visible to the app's team in the dashboard and pickup-able by the Remy agent. Backend only: wire it as frontend UI \u2192 app backend method \u2192 \`reportIssue\` (a browser can't call it; it uses the app's hook token, and the app id is derived server-side). \`kind\` is \`'bug'\` (default) or \`'idea'\`. \`reporter\` is a free-form display label (a name, email, or ticket id) \u2014 NOT an identity check and not tied to a user; pass the current user's email if you have it, or omit for anonymous. It returns the created issue \u2014 show \`result.number\` to confirm "Reported as #42". Rate limited per app (20/min): catch \`MindStudioError\` with \`code === 'rate_limited'\` and show a graceful "try again shortly" message, and debounce the submit button (every call creates a new issue \u2014 no dedupe).
 
   Table options: \`db.defineTable<T>(name, { unique, defaults })\`.
@@ -6065,7 +6067,7 @@ async function startMcpServer(options) {
           capabilities: { tools: {} },
           serverInfo: {
             name: "mindstudio-agent",
-            version: "0.1.68"
+            version: "0.1.69"
           },
           instructions: 'Welcome to MindStudio \u2014 a platform with 200+ AI models, 850+ third-party integrations, and pre-built agents.\n\nGetting started:\n1. Call `ask` with any question about the SDK \u2014 it knows every action, model, and connector and returns working code with real model IDs and config options. Examples: ask("generate an image with FLUX"), ask("what models support vision?"), ask("how do I send a Slack message?").\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.\n4. For manual browsing, call `listActions` to discover all available actions.\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 actions (text generation, image generation, video, audio, etc.) cost money. Before running these, call `estimateActionCost` 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.'
         });
@@ -6544,7 +6546,7 @@ Account:
   whoami                               Show current user and organization
   change-name <name>                   Update your display name
   change-profile-picture <url>         Update your profile picture
-  upload <filepath>                    Upload a file to the MindStudio CDN
+  upload <filepath>                    Upload a file to the CDN, print its URL (alias: upload-file)
   update                               Update to the latest version
 
 OAuth integrations:
@@ -7038,7 +7040,7 @@ function isNewerVersion(current, latest) {
   return false;
 }
 async function checkForUpdate() {
-  const currentVersion = "0.1.68";
+  const currentVersion = "0.1.69";
   if (!currentVersion) return null;
   try {
     const { loadConfig: loadConfig2, saveConfig: saveConfig2 } = await Promise.resolve().then(() => (init_config(), config_exports));
@@ -7067,7 +7069,7 @@ async function checkForUpdate() {
   }
 }
 function printUpdateNotice(latestVersion) {
-  const currentVersion = "0.1.68";
+  const currentVersion = "0.1.69";
   process.stderr.write(
     `
   ${ansi2.cyanBright("Update available")} ${ansi2.gray(currentVersion + " \u2192")} ${ansi2.cyanBold(latestVersion)}
@@ -7080,7 +7082,7 @@ function isStandaloneBinary() {
   return !argv1.includes("node_modules");
 }
 async function cmdUpdate() {
-  const currentVersion = "0.1.68";
+  const currentVersion = "0.1.69";
   process.stderr.write(
     `  ${ansi2.gray("Current version:")} ${currentVersion}
 `
@@ -7215,7 +7217,7 @@ async function cmdLogin(options) {
   process.stderr.write("\n");
   printLogo();
   process.stderr.write("\n");
-  const ver = "0.1.68";
+  const ver = "0.1.69";
   process.stderr.write(
     `  ${ansi2.bold("MindStudio Agent")} ${ver ? " " + ansi2.gray("v" + ver) : ""}
 `
@@ -7542,7 +7544,7 @@ async function main() {
   try {
     if (command === "version" || command === "-v") {
       process.stdout.write(
-        "0.1.68\n"
+        "0.1.69\n"
       );
       return;
     }
@@ -7732,20 +7734,22 @@ async function main() {
       });
       return;
     }
-    if (command === "upload") {
+    if (command === "upload" || command === "upload-file") {
       const filePath = positionals[1];
       if (!filePath)
         usageBlock([
-          "upload \u2014 Upload a file to the MindStudio CDN",
+          "upload \u2014 Upload a file to the MindStudio CDN (alias: upload-file)",
           "",
           "Usage:",
           "  mindstudio upload <filepath>",
           "",
           "Returns the permanent public URL for the uploaded file.",
+          "Use this to host a local file (e.g. a generated icon) and get a",
+          "URL \u2014 no need to write or trigger an app method.",
           "",
           "Examples:",
           "  mindstudio upload photo.png",
-          "  mindstudio upload /path/to/document.pdf"
+          "  mindstudio upload-file /path/to/document.pdf"
         ]);
       await cmdUpload(filePath, {
         apiKey: values["api-key"],