@mindstudio-ai/agent 0.1.22 → 0.1.24

package/dist/postinstall.js

@@ -3383,6 +3383,13 @@ var init_client = __esm({
        * ```
        */
       async executeStep(stepType, step, options) {
+        if (options?.onLog) {
+          return this._executeStepStreaming(
+            stepType,
+            step,
+            options
+          );
+        }
         const threadId = options?.threadId ?? (this._reuseThreadId ? this._threadId : void 0);
         const { data, headers } = await request(this._httpConfig, "POST", `/steps/${stepType}/execute`, {
           step,
@@ -3427,6 +3434,160 @@ var init_client = __esm({
           $billingEvents: billingEvents != null ? JSON.parse(billingEvents) : void 0
         };
       }
+      /**
+       * @internal Streaming step execution — sends `Accept: text/event-stream`
+       * and parses SSE events for real-time debug logs.
+       */
+      async _executeStepStreaming(stepType, step, options) {
+        const threadId = options.threadId ?? (this._reuseThreadId ? this._threadId : void 0);
+        const url = `${this._httpConfig.baseUrl}/developer/v2/steps/${stepType}/execute`;
+        const body = {
+          step,
+          ...options.appId != null && { appId: options.appId },
+          ...threadId != null && { threadId },
+          ...this._streamId != null && { streamId: this._streamId }
+        };
+        await this._httpConfig.rateLimiter.acquire();
+        let res;
+        try {
+          res = await fetch(url, {
+            method: "POST",
+            headers: {
+              Authorization: `Bearer ${this._httpConfig.token}`,
+              "Content-Type": "application/json",
+              "User-Agent": "@mindstudio-ai/agent",
+              Accept: "text/event-stream"
+            },
+            body: JSON.stringify(body)
+          });
+        } catch (err) {
+          this._httpConfig.rateLimiter.release();
+          throw err;
+        }
+        this._httpConfig.rateLimiter.updateFromHeaders(res.headers);
+        if (!res.ok) {
+          this._httpConfig.rateLimiter.release();
+          const errorBody = await res.json().catch(() => ({}));
+          throw new MindStudioError(
+            errorBody.message || `${res.status} ${res.statusText}`,
+            errorBody.code || "api_error",
+            res.status,
+            errorBody
+          );
+        }
+        const headers = res.headers;
+        try {
+          const reader = res.body.getReader();
+          const decoder = new TextDecoder();
+          let buffer = "";
+          let doneEvent = null;
+          while (true) {
+            const { done, value } = await reader.read();
+            if (done) break;
+            buffer += decoder.decode(value, { stream: true });
+            const lines = buffer.split("\n");
+            buffer = lines.pop() ?? "";
+            for (const line of lines) {
+              if (!line.startsWith("data: ")) continue;
+              try {
+                const event = JSON.parse(line.slice(6));
+                if (event.type === "log") {
+                  options.onLog({
+                    value: event.value,
+                    tag: event.tag,
+                    ts: event.ts
+                  });
+                } else if (event.type === "done") {
+                  doneEvent = {
+                    output: event.output,
+                    outputUrl: event.outputUrl,
+                    billingCost: event.billingCost,
+                    billingEvents: event.billingEvents
+                  };
+                } else if (event.type === "error") {
+                  throw new MindStudioError(
+                    event.error || "Step execution failed",
+                    "step_error",
+                    500
+                  );
+                }
+              } catch (err) {
+                if (err instanceof MindStudioError) throw err;
+              }
+            }
+          }
+          if (buffer.startsWith("data: ")) {
+            try {
+              const event = JSON.parse(buffer.slice(6));
+              if (event.type === "done") {
+                doneEvent = {
+                  output: event.output,
+                  outputUrl: event.outputUrl,
+                  billingCost: event.billingCost,
+                  billingEvents: event.billingEvents
+                };
+              } else if (event.type === "error") {
+                throw new MindStudioError(
+                  event.error || "Step execution failed",
+                  "step_error",
+                  500
+                );
+              } else if (event.type === "log") {
+                options.onLog({
+                  value: event.value,
+                  tag: event.tag,
+                  ts: event.ts
+                });
+              }
+            } catch (err) {
+              if (err instanceof MindStudioError) throw err;
+            }
+          }
+          if (!doneEvent) {
+            throw new MindStudioError(
+              "Stream ended without a done event",
+              "stream_error",
+              500
+            );
+          }
+          let output;
+          if (doneEvent.output != null) {
+            output = doneEvent.output;
+          } else if (doneEvent.outputUrl) {
+            const s3Res = await fetch(doneEvent.outputUrl);
+            if (!s3Res.ok) {
+              throw new MindStudioError(
+                `Failed to fetch output from S3: ${s3Res.status} ${s3Res.statusText}`,
+                "output_fetch_error",
+                s3Res.status
+              );
+            }
+            const envelope = await s3Res.json();
+            output = envelope.value;
+          } else {
+            output = void 0;
+          }
+          const returnedThreadId = headers.get("x-mindstudio-thread-id") ?? "";
+          if (this._reuseThreadId && returnedThreadId) {
+            this._threadId = returnedThreadId;
+          }
+          const returnedAppId = headers.get("x-mindstudio-app-id");
+          if (!this._appId && returnedAppId) {
+            this._appId = returnedAppId;
+          }
+          const remaining = headers.get("x-ratelimit-remaining");
+          return {
+            ...output,
+            $appId: headers.get("x-mindstudio-app-id") ?? "",
+            $threadId: returnedThreadId,
+            $rateLimitRemaining: remaining != null ? parseInt(remaining, 10) : void 0,
+            $billingCost: doneEvent.billingCost,
+            $billingEvents: doneEvent.billingEvents
+          };
+        } finally {
+          this._httpConfig.rateLimiter.release();
+        }
+      }
       /**
        * Execute multiple steps in parallel in a single request.
        *
@@ -4645,7 +4806,7 @@ async function startMcpServer(options) {
           capabilities: { tools: {} },
           serverInfo: {
             name: "mindstudio-agent",
-            version: "0.1.22"
+            version: "0.1.24"
           },
           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.'
         });
@@ -5275,9 +5436,25 @@ async function cmdExec(method, input, options) {
       `Unknown action: ${method}. Run 'mindstudio list-actions' to see available actions.`
     );
   }
+  let onLog;
+  if (options.jsonLogs) {
+    onLog = (log) => {
+      process.stderr.write(
+        JSON.stringify({ type: "log", value: log.value, tag: log.tag, ts: log.ts }) + "\n"
+      );
+    };
+  } else if (process.stderr.isTTY) {
+    onLog = (log) => {
+      process.stderr.write(
+        `  ${ansi2.cyan("\u27E1")} ${ansi2.gray(log.value)}
+`
+      );
+    };
+  }
   const result = await agent.executeStep(meta.stepType, input, {
     appId: options.appId,
-    threadId: options.threadId
+    threadId: options.threadId,
+    onLog
   });
   if (options.outputKey) {
     const val = result[options.outputKey];
@@ -5485,7 +5662,7 @@ function isNewerVersion(current, latest) {
   return false;
 }
 async function checkForUpdate() {
-  const currentVersion = "0.1.22";
+  const currentVersion = "0.1.24";
   if (!currentVersion) return null;
   try {
     const { loadConfig: loadConfig2, saveConfig: saveConfig2 } = await Promise.resolve().then(() => (init_config(), config_exports));
@@ -5514,7 +5691,7 @@ async function checkForUpdate() {
   }
 }
 function printUpdateNotice(latestVersion) {
-  const currentVersion = "0.1.22";
+  const currentVersion = "0.1.24";
   process.stderr.write(
     `
   ${ansi2.cyanBright("Update available")} ${ansi2.gray(currentVersion + " \u2192")} ${ansi2.cyanBold(latestVersion)}
@@ -5527,7 +5704,7 @@ function isStandaloneBinary() {
   return !argv1.includes("node_modules");
 }
 async function cmdUpdate() {
-  const currentVersion = "0.1.22";
+  const currentVersion = "0.1.24";
   process.stderr.write(
     `  ${ansi2.gray("Current version:")} ${currentVersion}
 `
@@ -5642,7 +5819,7 @@ async function cmdLogin(options) {
   process.stderr.write("\n");
   printLogo();
   process.stderr.write("\n");
-  const ver = "0.1.22";
+  const ver = "0.1.24";
   process.stderr.write(
     `  ${ansi2.bold("MindStudio Agent")} ${ver ? " " + ansi2.gray("v" + ver) : ""}
 `
@@ -5914,6 +6091,7 @@ async function main() {
       "thread-id": { type: "string" },
       "output-key": { type: "string" },
       "no-meta": { type: "boolean", default: false },
+      "json-logs": { type: "boolean", default: false },
       workflow: { type: "string" },
       version: { type: "string" },
       type: { type: "string" },
@@ -5946,7 +6124,7 @@ async function main() {
   try {
     if (command === "version" || command === "-v") {
       process.stdout.write(
-        "0.1.22\n"
+        "0.1.24\n"
       );
       return;
     }
@@ -6367,7 +6545,8 @@ async function main() {
       appId: values["app-id"],
       threadId: values["thread-id"],
       outputKey: values["output-key"],
-      noMeta: values["no-meta"]
+      noMeta: values["no-meta"],
+      jsonLogs: values["json-logs"]
     });
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
@@ -6427,6 +6606,7 @@ Options:
   --thread-id <id>   Thread ID for state persistence
   --output-key <key> Extract a single field from the result
   --no-meta          Strip $-prefixed metadata from output
+  --json-logs        Stream debug logs as JSONL to stderr
   --workflow <name>  Workflow to execute (run-agent only)
   --version <ver>    App version, e.g. "draft" (run-agent only)
   --json             Output as JSON

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mindstudio-ai/agent",
-  "version": "0.1.22",
+  "version": "0.1.24",
   "description": "TypeScript SDK for MindStudio direct step execution",
   "type": "module",
   "main": "./dist/index.js",