@mindstudio-ai/agent 0.1.47 → 0.1.48

package/dist/cli.js

@@ -2776,15 +2776,16 @@ var init_table = __esm({
       // -------------------------------------------------------------------------
       // Internal helpers
       // -------------------------------------------------------------------------
-      /** @internal Throw if data includes a platform-managed email/phone column. */
+      /** @internal Throw if data includes a platform-managed read-only column. */
       _checkManagedColumns(data) {
         const mc = this._config.managedColumns;
         if (!mc) return;
         const keys = Object.keys(data);
         for (const key of keys) {
-          if (mc.email && key === mc.email || mc.phone && key === mc.phone) {
+          if (mc.email && key === mc.email || mc.phone && key === mc.phone || mc.apiKey && key === mc.apiKey) {
+            const friendly = key === mc.email ? "email" : key === mc.phone ? "phone" : "API key";
             throw new MindStudioError(
-              `Cannot write to "${key}" \u2014 this column is managed by auth. Use the auth API to change a user's ${key === mc.email ? "email" : "phone"}.`,
+              `Cannot write to "${key}" \u2014 this column is managed by auth. Use the auth API to change a user's ${friendly}.`,
               "managed_column_write",
               400
             );
@@ -3854,48 +3855,80 @@ var init_client = __esm({
           );
         }
         const threadId = options?.threadId ?? (this._reuseThreadId && !getRequestContext() ? this._threadId : void 0);
-        const { data, headers } = await request(this._httpConfig, "POST", `/steps/${stepType}/execute`, {
+        const { data: asyncData, headers } = await request(this._currentHttpConfig, "POST", `/steps/${stepType}/execute-async`, {
           step,
           ...options?.appId != null && { appId: options.appId },
           ...threadId != null && { threadId },
           ...this._currentStreamId != null && { streamId: this._currentStreamId }
         });
-        let output;
-        if (data.output != null) {
-          output = data.output;
-        } else if (data.outputUrl) {
-          const res = await fetch(data.outputUrl);
+        const remaining = headers.get("x-ratelimit-remaining");
+        const returnedThreadId = asyncData.threadId ?? "";
+        if (this._reuseThreadId && returnedThreadId && !getRequestContext()) {
+          this._threadId = returnedThreadId;
+        }
+        if (!this._appId && asyncData.appId && !getRequestContext()) {
+          this._appId = asyncData.appId;
+        }
+        const pollUrl = `${this._currentHttpConfig.baseUrl}/developer/v2/steps/${stepType}/execute-async/poll/${asyncData.executionToken}`;
+        let pollDelay = 100;
+        while (true) {
+          await sleep3(pollDelay);
+          pollDelay = Math.min(pollDelay * 2, 5e3);
+          const res = await fetch(pollUrl, {
+            headers: { "User-Agent": "@mindstudio-ai/agent" }
+          });
+          if (res.status === 502 || res.status === 503 || res.status === 504) continue;
+          if (res.status === 404) {
+            throw new MindStudioError(
+              `[${stepType}] Execution token expired.`,
+              "poll_token_expired",
+              404
+            );
+          }
           if (!res.ok) {
+            const errorBody = await res.json().catch(() => ({}));
             throw new MindStudioError(
-              `Failed to fetch ${stepType} output from S3: ${res.status} ${res.statusText}`,
-              "output_fetch_error",
-              res.status
+              errorBody.message ?? errorBody.error ?? `[${stepType}] Poll failed: ${res.status} ${res.statusText}`,
+              errorBody.code ?? "poll_error",
+              res.status,
+              errorBody
             );
           }
-          const envelope = await res.json();
-          output = envelope.value;
-        } else {
-          output = void 0;
-        }
-        const returnedThreadId = headers.get("x-mindstudio-thread-id") ?? "";
-        if (this._reuseThreadId && returnedThreadId && !getRequestContext()) {
-          this._threadId = returnedThreadId;
-        }
-        const returnedAppId = headers.get("x-mindstudio-app-id");
-        if (!this._appId && returnedAppId && !getRequestContext()) {
-          this._appId = returnedAppId;
+          const poll = await res.json();
+          if (poll.status === "pending") continue;
+          if (poll.status === "error") {
+            throw new MindStudioError(
+              `[${stepType}] ${poll.error ?? "Step execution failed."}`,
+              "step_error",
+              500
+            );
+          }
+          let output;
+          if (poll.output != null) {
+            output = poll.output;
+          } else if (poll.outputUrl) {
+            const s3Res = await fetch(poll.outputUrl);
+            if (!s3Res.ok) {
+              throw new MindStudioError(
+                `Failed to fetch ${stepType} output from S3: ${s3Res.status} ${s3Res.statusText}`,
+                "output_fetch_error",
+                s3Res.status
+              );
+            }
+            const envelope = await s3Res.json();
+            output = envelope.value;
+          } else {
+            output = void 0;
+          }
+          return {
+            ...output,
+            $appId: poll.appId ?? asyncData.appId ?? "",
+            $threadId: poll.threadId ?? returnedThreadId,
+            $rateLimitRemaining: remaining != null ? parseInt(remaining, 10) : void 0,
+            $billingCost: poll.billingCost,
+            $billingEvents: poll.billingEvents
+          };
         }
-        const remaining = headers.get("x-ratelimit-remaining");
-        const billingCost = headers.get("x-mindstudio-billing-cost");
-        const billingEvents = headers.get("x-mindstudio-billing-events");
-        return {
-          ...output,
-          $appId: headers.get("x-mindstudio-app-id") ?? "",
-          $threadId: returnedThreadId,
-          $rateLimitRemaining: remaining != null ? parseInt(remaining, 10) : void 0,
-          $billingCost: billingCost != null ? parseFloat(billingCost) : void 0,
-          $billingEvents: billingEvents != null ? JSON.parse(billingEvents) : void 0
-        };
       }
       /**
        * @internal Streaming step execution — sends `Accept: text/event-stream`
@@ -5525,7 +5558,7 @@ async function startMcpServer(options) {
           capabilities: { tools: {} },
           serverInfo: {
             name: "mindstudio-agent",
-            version: "0.1.47"
+            version: "0.1.48"
           },
           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.'
         });
@@ -6482,7 +6515,7 @@ function isNewerVersion(current, latest) {
   return false;
 }
 async function checkForUpdate() {
-  const currentVersion = "0.1.47";
+  const currentVersion = "0.1.48";
   if (!currentVersion) return null;
   try {
     const { loadConfig: loadConfig2, saveConfig: saveConfig2 } = await Promise.resolve().then(() => (init_config(), config_exports));
@@ -6511,7 +6544,7 @@ async function checkForUpdate() {
   }
 }
 function printUpdateNotice(latestVersion) {
-  const currentVersion = "0.1.47";
+  const currentVersion = "0.1.48";
   process.stderr.write(
     `
   ${ansi2.cyanBright("Update available")} ${ansi2.gray(currentVersion + " \u2192")} ${ansi2.cyanBold(latestVersion)}
@@ -6524,7 +6557,7 @@ function isStandaloneBinary() {
   return !argv1.includes("node_modules");
 }
 async function cmdUpdate() {
-  const currentVersion = "0.1.47";
+  const currentVersion = "0.1.48";
   process.stderr.write(
     `  ${ansi2.gray("Current version:")} ${currentVersion}
 `
@@ -6659,7 +6692,7 @@ async function cmdLogin(options) {
   process.stderr.write("\n");
   printLogo();
   process.stderr.write("\n");
-  const ver = "0.1.47";
+  const ver = "0.1.48";
   process.stderr.write(
     `  ${ansi2.bold("MindStudio Agent")} ${ver ? " " + ansi2.gray("v" + ver) : ""}
 `
@@ -6986,7 +7019,7 @@ async function main() {
   try {
     if (command === "version" || command === "-v") {
       process.stdout.write(
-        "0.1.47\n"
+        "0.1.48\n"
       );
       return;
     }

package/dist/index.d.ts

@@ -656,12 +656,13 @@ interface TableConfig {
     defaults?: Record<string, unknown>;
     /**
      * Platform-managed auth columns. Set when this table is the app's auth
-     * table. Writes to email/phone columns throw; roles writes are allowed.
+     * table. Writes to email/phone/apiKey columns throw; roles writes are allowed.
      */
     managedColumns?: {
         email?: string;
         phone?: string;
         roles?: string;
+        apiKey?: string;
     };
     /**
      * Sync role changes to the platform after a successful auth table write.
@@ -956,7 +957,7 @@ declare class Table<T> {
      * @param data - Row data to insert (or update on conflict). Defaults apply.
      */
     upsert(conflictKey: (keyof Omit<T, SystemFields> & string) | (keyof Omit<T, SystemFields> & string)[], data: PushInput<T>): Mutation<T>;
-    /** @internal Throw if data includes a platform-managed email/phone column. */
+    /** @internal Throw if data includes a platform-managed read-only column. */
     private _checkManagedColumns;
     /**
      * @internal Fire role sync for rows that wrote to the roles column.

package/dist/index.js

@@ -1493,15 +1493,16 @@ var Table = class {
   // -------------------------------------------------------------------------
   // Internal helpers
   // -------------------------------------------------------------------------
-  /** @internal Throw if data includes a platform-managed email/phone column. */
+  /** @internal Throw if data includes a platform-managed read-only column. */
   _checkManagedColumns(data) {
     const mc = this._config.managedColumns;
     if (!mc) return;
     const keys = Object.keys(data);
     for (const key of keys) {
-      if (mc.email && key === mc.email || mc.phone && key === mc.phone) {
+      if (mc.email && key === mc.email || mc.phone && key === mc.phone || mc.apiKey && key === mc.apiKey) {
+        const friendly = key === mc.email ? "email" : key === mc.phone ? "phone" : "API key";
         throw new MindStudioError(
-          `Cannot write to "${key}" \u2014 this column is managed by auth. Use the auth API to change a user's ${key === mc.email ? "email" : "phone"}.`,
+          `Cannot write to "${key}" \u2014 this column is managed by auth. Use the auth API to change a user's ${friendly}.`,
           "managed_column_write",
           400
         );
@@ -3672,48 +3673,80 @@ var MindStudioAgent = class {
       );
     }
     const threadId = options?.threadId ?? (this._reuseThreadId && !getRequestContext() ? this._threadId : void 0);
-    const { data, headers } = await request(this._httpConfig, "POST", `/steps/${stepType}/execute`, {
+    const { data: asyncData, headers } = await request(this._currentHttpConfig, "POST", `/steps/${stepType}/execute-async`, {
       step,
       ...options?.appId != null && { appId: options.appId },
       ...threadId != null && { threadId },
       ...this._currentStreamId != null && { streamId: this._currentStreamId }
     });
-    let output;
-    if (data.output != null) {
-      output = data.output;
-    } else if (data.outputUrl) {
-      const res = await fetch(data.outputUrl);
+    const remaining = headers.get("x-ratelimit-remaining");
+    const returnedThreadId = asyncData.threadId ?? "";
+    if (this._reuseThreadId && returnedThreadId && !getRequestContext()) {
+      this._threadId = returnedThreadId;
+    }
+    if (!this._appId && asyncData.appId && !getRequestContext()) {
+      this._appId = asyncData.appId;
+    }
+    const pollUrl = `${this._currentHttpConfig.baseUrl}/developer/v2/steps/${stepType}/execute-async/poll/${asyncData.executionToken}`;
+    let pollDelay = 100;
+    while (true) {
+      await sleep3(pollDelay);
+      pollDelay = Math.min(pollDelay * 2, 5e3);
+      const res = await fetch(pollUrl, {
+        headers: { "User-Agent": "@mindstudio-ai/agent" }
+      });
+      if (res.status === 502 || res.status === 503 || res.status === 504) continue;
+      if (res.status === 404) {
+        throw new MindStudioError(
+          `[${stepType}] Execution token expired.`,
+          "poll_token_expired",
+          404
+        );
+      }
       if (!res.ok) {
+        const errorBody = await res.json().catch(() => ({}));
         throw new MindStudioError(
-          `Failed to fetch ${stepType} output from S3: ${res.status} ${res.statusText}`,
-          "output_fetch_error",
-          res.status
+          errorBody.message ?? errorBody.error ?? `[${stepType}] Poll failed: ${res.status} ${res.statusText}`,
+          errorBody.code ?? "poll_error",
+          res.status,
+          errorBody
         );
       }
-      const envelope = await res.json();
-      output = envelope.value;
-    } else {
-      output = void 0;
-    }
-    const returnedThreadId = headers.get("x-mindstudio-thread-id") ?? "";
-    if (this._reuseThreadId && returnedThreadId && !getRequestContext()) {
-      this._threadId = returnedThreadId;
-    }
-    const returnedAppId = headers.get("x-mindstudio-app-id");
-    if (!this._appId && returnedAppId && !getRequestContext()) {
-      this._appId = returnedAppId;
+      const poll = await res.json();
+      if (poll.status === "pending") continue;
+      if (poll.status === "error") {
+        throw new MindStudioError(
+          `[${stepType}] ${poll.error ?? "Step execution failed."}`,
+          "step_error",
+          500
+        );
+      }
+      let output;
+      if (poll.output != null) {
+        output = poll.output;
+      } else if (poll.outputUrl) {
+        const s3Res = await fetch(poll.outputUrl);
+        if (!s3Res.ok) {
+          throw new MindStudioError(
+            `Failed to fetch ${stepType} output from S3: ${s3Res.status} ${s3Res.statusText}`,
+            "output_fetch_error",
+            s3Res.status
+          );
+        }
+        const envelope = await s3Res.json();
+        output = envelope.value;
+      } else {
+        output = void 0;
+      }
+      return {
+        ...output,
+        $appId: poll.appId ?? asyncData.appId ?? "",
+        $threadId: poll.threadId ?? returnedThreadId,
+        $rateLimitRemaining: remaining != null ? parseInt(remaining, 10) : void 0,
+        $billingCost: poll.billingCost,
+        $billingEvents: poll.billingEvents
+      };
     }
-    const remaining = headers.get("x-ratelimit-remaining");
-    const billingCost = headers.get("x-mindstudio-billing-cost");
-    const billingEvents = headers.get("x-mindstudio-billing-events");
-    return {
-      ...output,
-      $appId: headers.get("x-mindstudio-app-id") ?? "",
-      $threadId: returnedThreadId,
-      $rateLimitRemaining: remaining != null ? parseInt(remaining, 10) : void 0,
-      $billingCost: billingCost != null ? parseFloat(billingCost) : void 0,
-      $billingEvents: billingEvents != null ? JSON.parse(billingEvents) : void 0
-    };
   }
   /**
    * @internal Streaming step execution — sends `Accept: text/event-stream`